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1 / Introduction 



The brain of the Color Computer is the 6809 Micropro- 
cessor. It is always operating in 6S09 machine code, the 
only language it knows. 

When you program in BASIC, a RDM program called the 
BASIC Interpreter "'translates'" each statement one at a 
time, into 6609 machine code. 

The Editor- Assembler- allows you to write a program in 
6809 assembly language and assemble it into a single, 
efficient B80G machine code program. This gives you 
two very powerful advantages: 

• You are no longer limited to the commands in the BASIC 
language. 

• Many steps that are necessary to interpret a BASIC 
statement into machine code will no longer be needed. 
Therefore, the programs you write with the Editor- 
Assembler + will run much faster, and probably use 
less memory. 

Tnis manual demonstrates how to use the Editor- 
Assembler i . It will not teach you how to program in 
assembly language. Radio Shack has an excellent book 
devoted to the subject. It's Catalog Number is 62-2077. 
You can purchase it through any Radio Shack store. 

The Editor- Assembler - contains three systems; 

- The Editor, for writing and editing 6609 assembly lan- 
guage programs. 

- The Assembler, for assembling the programs into 
5809 machine code. 

• ZBUG, for examining and debugging your machine 
code programs. 

To use them, all you need is a Color Computer with 16K 
RAM and a tape recorder. 

How You Will Use 
These Systems 

1, First you'll write the program in assembly language. 



using mnemonics which the Assembler recognizes 
and which is fairty easy to use. This is done in the 
Editor and the resulting program listing is called TEXT 

2. Then you'll assemble the instructions of TEXT into 
machine code which the 6809 Microprocessor can 
recognize, but which looks like nonsense to most peo- 
ple, ihus. you'll create CODE consisting of op codes 
and data. 

3. You'll use ZBUG to test and debug CODE until it's per- 
fect. Then you'll store it on tape. Storing CODE is the 
final task of the Editor- Assembler ■ . 

4. From BASIC, you'll toad CODE Cwith CLOADM) and 
run it You can either run it as a stand -alone program 
[with EXEC) or as a subroutine [with USR). 

How This Manual 
Will Guide You 

This manual will walk you through all these steps and also 
give you some useful information about your Editor- 
Assembler +. 

In Chapter 2, well explore memory. You'll need this foun- 
dation to understand the rest of the manual. We'll do this 
with ZBUG. 

Chapters 3 t 4, S t and Swill show you how to write the 
program, assemble it and debug it. Finally in Chapter 7, 
well show you how to run the program from BASIC- 

If you've used other editor-assemblers, you might want to 
start with the Appendixes. There, you'll find all the com- 
mands summarized with page number references. 

And Now Let's Get On 
With It . . . 

To use the Editor- Assembler + , follow these steps: 
1 . Turn OFF the computer. 
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2 J nsert the ROM pack into the slot On the right sfde of E0TA5M+ t,a 
the computer. copyright ft lgsi by microsoft 

3. Turn ihe Computer ON, * 

When you turn the computer OH you will see: T he asterisk prompt (.') tells you that the Editor is now 

available. We say you are 7rf the Editor, 
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To use the Editor-Assembler + , you must have a good 
understanding of the Color Computer's memory. You wili 
need to know about memory to write the program, 
assemble it, debug it, and execute it. 

In this Chapter, we'll explore memory and see some of 
the many ways you can get the information you want. To 

do thus, we'll useZBUG. 

Type: 
z 



and ZBUG will display its # prompt. You are now "in" 
ZBUG and you may enter a ZBUG command. 

All ZBUG commands must be entered in th is c omma nd 
level.. You can return to it by pressing :BR^fliO or cehter) . 

Examining a Memory Location 

The 6909 can address 65,536 one- byte memory loca- 
tions, numbered 0-55535 C00O0-FFFF hexadecimal). 
Well examine hexadecimal location C00O. the beginning 
of the Editor- Assembler program. Type: 

C000/ 

LDA #6 is the "mnemonic' 1 instruction that begins at loca- 
tion GOOD. 

To examine the next instructions, press the S. Use the 
© to get back to a preceding location. Notice that when 
you use the G»J the screen continues to scroll down. The 
smaller addresses are displayed at the bottom of the 
screen. 

Also notice that the © will increment by more than one 
byte in this particular examination mode, More on this in 
the following pages. 

The £*D, however will always decrement the address by 
one, regardless of the examination mode. 

All the numbers you see are hexadecimal. Hexadecimal 
means base 16. You will see not only the ten numeric dig- 
its, but also the six alpha characters needed for base 16 
CA-F1 ZBUG assumes you want to see base 16 numbers 
unless you specify another base (which we'll do in 
Chapter 61 



Notice that a zero precedes all the hexadecimal numbers 
beginning with an alphabetic character. This is done to 
avoid any contusion between hexadecimal numbers and 
registers. 

Examining Modes 

To help you interpret the contents of memory, ZBUG 
offers four ways of looking at it: 

Byte Mode 

Type (BHEftK) to get into the command level and then type: 
B CENTER) 

Examine the contents beginning at location COdO again. 
LDA #6 is now represented as a number. 86 is the op 
code for LDA. The operand, 6, is in location C001 . 

The byte mode displays every byte of memory as a num- 
ber, whether it is part of a machine language program 
or data. 

In this examination mode, the 00 increments the address 
by one. 

Word Mode 

Get back into the command level and type: 

Look at the same memory. Press the ® key a few times. 
The numbers are the same, but you are seeing them two 
bytes or one word at a time. 

Here, the ® increments the address by two. 

ASCII Mode 

From the command level, type: 
a dSHE 

ZBUG is now assuming that the contents of each mem* 
on/ location is an ASCII code. If the "code" is between 21 
and 7F [hexadecimal}. ZBUG displays the character it 
represents. Otherwise, it displays nothing. 

Examine the locations beginning with 0056. These loca- 
tions contain the Editor- Assembler- display heading. 
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Nate: ZBUG will also display the A 1 through FFas 
ASCli characters. However, they are not the True 
characters which these codes represent. 

Here, the © increments the address by one. 

Mnemonic Mode 

This is the default mode. Unless you ask for some other 
mode, as we have been doing, you will be in the default 
mode. To return to it, get in the command level and type: 

M iIhtIE.i 

Look at the location s beginning at CQAO again. You II see 
the same instructions you saw at the beginning of this 
chapter 

CflBfl/ LDA *6 

pa 82/ STA>BFF 

etc 

In this mode. ZBUG assumes you're examining a 
machine language program. It examines memory from 
one to five bytes at a time by "disassembling" the num- 
bers into the mnemonics they represent. The number 
&606 If ram locations C000 and CO0 13 has been disas- 
sembled into LDA #6; B70QFF (from locations- C002, 
C003, and C0O4) into STA FF; etc. 



Begin tire disassembly at a different byte, lype f SHEEl D 
coBi/ and press the ® several times. You will see a 
different disassembly: 

R0R<flB7 



cm 3 f 

ca&3,' 
etc. 



NEG<0FF 



The contents of memory have not changed. ZBUG has, 
however, interpreted them differently. The number 06B 7 
(from locations CDQ1 and CQQ2) has been disassembled 
into ROR- OB 7: OOFF (from locations COOS and C004) 
has been disassembled into NEC-- OFF; etc. 

To see the program correctly, you must be sure you are 
beginning on the correct byte. Sometimes, several bytes 
will contain "77 This means ZBUG can't figure out what 
instruction is in thai byte and is possibly disassembling 
from the wrong point. Unfortunately, though, the only 
sure way of knowing if you're on the right byte is by know- 
ing where the program starts. 

Changing Memory 

As you look at the contents of memory locations, notice 
that the cursor is to the right, This allows you to change 
the contents of that location. After typing the new con- 
tents, press iJHTFR) or © and the change will be made. 

For an example of changing memory, we'll open a loca- 
tion in Random Access Memory (RAM). Up to now. we've 



only been examining locations in Read Only Memory 
[ROM) which we can't change. Get into the byte mode 
and open location 10AA by typing: 

(BRIER b MM 
10AA/ 

Note that the cursor is to the nght. Type: 

i mm 

and the location now contains a 1. You can accomplish 
the same thing by typing: 

10AA/ 
and then: 

which changes the contents to DDjand allows you to 
change the next location. (Press [*J to see that the 
change has been made.) 

The size of the changes you make will depend on the 
examination mode you are in. In byte mode, you will 
change one byte only and can type ore or two dig lis. 

In the word mode, you will be changing one word at a 
time. Any one. two, three or four digit number you type 
will be the new value of the word. 

if you happen to type a number which is also the name of 
one of the 6S09 registers [A r B.D.-CGiDP,X,Y,U,S.PC). 
ZBUG will assume it's a register and give you an 
"EXPRESSION ERROR; To avoid this confusion, type a 
leading zero (OA P 0B,etc.J. 

To change memory in the ASCI! mode, use an apos- 
trophe before the new letter. For example, to write the let- 
ter A in memory at location 0000. type: 

A [EHTEK ] 

to go into ASCII examination mode, type: 

0000/ 
to open that location and type: 

'A M 
to change it. Typing the (*} will assure you that the loca- 
tion contains the letter A. 

If you are in mnemonic mode, you are expected to 

change one to five bytes of memory depending on the 
length of the particular instruction. Things get just a bit 
complex in mnemonic mode because you can't use mne- 
monic assembly language instructions. You must use the 
op code equivalent instead. 

For example, get into the mnemonic mnde and open 
location 1000. Type: 



1 ENTER 

1000/ 




to ch^ge this instruction, type: Exploring the ComDuter's 

16 lWm Mernorv 

Now location 1O00 contains the op Code for the LDA ' 

instruction. Open location 1001 : You are now invited to examine each section of memory 

iei01/ using ZBUG commands to change examination modes. 

. . . M Use the Memory Map in Appendix E. 
and insert 06, the operand: 

0S HESTER' The following activities wi!J ailow you to become familiar 

with the Editor so don't be afraid to try commands or 

Upon examining location 1000 again, you II see it now change memory You can restore anything you after by 

contains a LDA #6 instruction. simply turning the computer OFF and ON again. 
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To write assembly language programs, you will use the 
Editor. You can enter it by pcwering-up, pressing RESET, 
or (from ZBUGJ typing e CEnteh j. The asterisk prompt tells 
you that the Editor is available for commands. We say 
you are "/fl" the Editor, 

The Editor has quite an assortment of commands to 
assist you. To use any of them, you must be at command 
level, as you are now. You can return to this command 
level by pressing i&REAK:, 

Sample Programming 

Exercise 

For those of you new to editor-assemblers, we're includ- 
ing this sample programming exercise. We'll be referring 
to it in our examples throughout the manual. If you've 
used other editor-assemblers, you may skip this exercise 
and begin reading about the Write command. 

To get started, type; 
i iJHTlB) 

Even though you have not typed anything yet, the Editor 
thinks that you are inserting lines into an already existing, 
although empty, edit buffer. 

The Editor will respond with a line number. This Sine num- 
ber is for your convenience while in the Editor and will not 
affect the machine language program at all. 

To insert a comment line, type an asterisk and comment 
away For example, insert this line: 

00100 *THIS IS A COMMENT LINE SlNTlRi 

The Assembler will ignore comment lines. You may type 
as many of them as you wish to explain your program to 
passing humans without confusing the computer. 

You may delete this line and start over by press ire ■break 
to get back into the command level and then typing: 

D100 OTED 

To type a program line, you will use four fields: the sym- 
bol, command, operand and comment fields. You can tab 
from one field to the next by pressing the L*j key. 



Insert this program line, using the CD key to tab from one 
column to the next: 

00100 SYMBOL CMD flPEPflND COMMENT CE NTER) 

The symbol, command and operand fields must be ter- 
minated by a tab, space or carriage return. The symbol 
may be up to six characters. The comment is optional. 
The maximum line length is 128 characters. Note that 
long lines wilt "wrap around" your screen to the next line. 

Delete whatever lines you have in the edit buffer and 
insert the following sample program. You may omit the 
comments, if you like: 



00 100 


START 


LDG **0F3 


LOAD ASCH CHAR 


£0110 




LDK *H500 


BEGIN UIDEO MEM 


00120 


SCREEN 


STA ,X + 


PUT CHAP ON SCREEN 


30133 




CtfPX **5FF 


SEE IF END UIDEO MEM 


Gil 40 




BNE SCREEN 


BRANCH IF NOT 


00*50 


DONE 


BUI 




001E0 




END 





This stores graphics character number F9 into video 
memory locations 50O-5FF The dollar symbol Cs) indi- 
cates a hexadecimal number. Without this symbol, the 
Editor will assume the number is decimal. [Note that the 
Editor defaults to decimal, whereas ZBUG defaults to 
hexadecimal.) 

A description of all the other symbols, as well as the 5609 
instructions, are in Part Two. "6809 Programming Ref- 
erence Section.' 8 

Write Command 

W filename 

To save the sample program to tape (before making any 
experimental changes), type: 

W SAMPLE (Efit'ER 



You will be prompted with -READY CASSETTE 1 ". When 
the recorder ts ready to record (i.e., you have inserted a 
tape and pressed PLAY and RECORD], type ( ISTer :, Your 
program will be saved as a "TEXT' file. 
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If you don't give your fife a name, the default name 
NONA ME will be assigned. It is a good idea to use file- 
names, especiaJiy if you will oc storing more I nan one file 
on a sinpje tape, Filenames may be up to eight charac- 
ters long and must begin with a letter ot the alphabet. 

We recommend that you make a copy of your program 
before executing it. An assembly fanguage program is 
not nearly as forgiving as BASIC. Executing the program 
with even a very small bug might result in erasing the 
entire edit Duller In less than a second, many hours of 
editing and trial assembly can be completely ob* iterated! 

After writing the file, it is useful to verify the tape with the 
V command. This command verifies the checksum on the 
tape. This venlccalfon coufd save frustration when saving 

long programs. The V command is listed in Appendix A. 

Load Command 

L filename 

To load the TEXT file from tape, type: 
L SAMPLE i flTCER : 

You will be prompted to get your cassette recorder ready. 
(Rewind the tape and press PLAY.) When you press 
:iNT_ERi. the recorder will begin searching for a tile named 
SAMPLE. If you just want the first life, or whatever fife is 
next on the tape, you may omit the filename. 

This command will load a TEXT file only. (You will use the 
BASIC GLOADM command to load your assembled 
CODE file.] 

Note: The Editor does not automatically empty its 
puffer before 3 LOAD, ft a program is currently in 
memory, the program being LOADed will be 

appended to the one in memory. 

This can be useful for chaining long programs. 
When {he Second file is loaded simply renumber 

them He., Nioo t 1001 

if you do not desire this, empty the buffer before 
loading fl n&w program li. e. . D$ : "). 

Print Command 

Prange 

To print a line of the program on the screen, type: 



To print more than one line, type: 
P1BGM3B (HfflEfl) 

Since the first line, last line, and current line are very 
often referred to. you can refer to them with a single 
character 

■ first line 



* last line 

cu rrent I i ne (the last line you pri nted or i nserted ) 

To print the current Itne, type: 
P- INTER 1 

To print the entire text of the sample program, type: 
?'i* CEHTEffi 

This is the same as pi 00:1 so (enter). 

The colon separates the beginning and ending lines in a 
range of lines Another way to specify a range of fines is 
with ! . Type: 

f>*i3 ishm: 

and five fines of your program, beginning with the first 
one, will be printed on the screen. 

To stop the listing, you may quickly type: 
MIFT & 

To continue, press any hey. 

Printer Commands 

H range 
Jrange 

H you have a printer, you can print your program with the 

H and T commands. Both are closely related to the 
P command. 

H«:* ENTER 

will pnnt every line of the edit buffer to the printer. You will 
be prompted with: 

PRINTER READY 

and you should respond with frnrJK; when ready. 

"100 !S (ENTER} 

will print six lines, beginning with line 100. to the printer 

but without the Editor-supplied line numbers. 

Edit Command 

Eiine 

You can edit lines in the same way you edit Extended 
BASIC lines. For example, to edit line 100. type; 
ElGfl ;entTr 

The new line 100 is below old line 100 ready to be 

changed. 

Press the SPACEBAR to position the cursor just after 

START and type this insert subcommand: 

I ED JHTER) 
which inserts ED in the line. 

All the edit subcommands are listed in Appendix A. 
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Delete Command 

D range 

If you are using the sample program, be sure you have 
written it on tape before you experiment with this com- 
mand. Type: 

DllOsUEl ( ENTER) 
Lines 1 10 through 140 are gone. 

Insert Command 

I starttine. increment 

Type: 

I152tZ IENTERi 

You may now insert lines beginning with line 152. Each 
lire will be incremented by 2. (The Editor will not allow 
you to accidentJy overwrite an existing line. When you get 
to line 160, it will give you an error message.) 



Press : break': to return to the command level and type' 
1170 INTER' 

This allows you to begin inserting lines at the end ot the 
program. Each line will again be incremented by 2, the 
last increment you used. 

Type: 

BREAKS i [ENTER 

The Editor will begin inserting at the current line. 

On start-up. the Editor sets the current line to 100 and the 
increment to 10. You may use any line numbers between 
and 63999. 

Renumber Command 

Nstartline, increment 

Another command that helps with inserting lines between 
the lines is N [for neNumber). From the command Eevel, 
type: 



N100P5O LENTERJ 

Now the lines begin with line 1 00 and are all incremented 
by 50. This allows you much more room for inserting 1 
between lines. 

Type: 



N r EITTER . 

The current line is now the first line number. 

Renumber now so we will all be together for the next 
instruction. Type: 

M10l£ .:e ENTER) 



Replace Command 

R startline. increment 

The replace command is a variation of the insert com- 
mand. Type: 

R1BG.2 '.ENTER' 

You may now replace line 100 with a new line and begin 
inserting lines using an increment of three. 

Copy Command 

Cslariiine t range. Increment 

The copy command will save you a lot of typing by dupli- 
cating any part of your program to another location in the 
program. 

To copy lines, type: 



C500 .- IE 3: 153 rlE LENTERi 

This wil! copy the range of lines from 1 00 to 1 50 to a new 
location beginning at line 500, with a line increment of 10. 
An attempt to copy lines over each other will tail. 

ZBUG Command 

To exit the Editor and enter ZBUG, type: 

Z ENTERi 

A different prompt, the *, tells you that you are now in 
ZBUG. 

To re-enter the editor from ZBUG. type the ZBUG 
command: 

e [enter: 

If you print your program, you'll see that entering and 
exiting ZBUG did not change it. 

BASIC Command 

To enter BASIC from the Editor type: 

o CEjrriJi) 
for Quit. To re-enter the Editor from BASIC, type: 



EXEC 49 152 (ENTERi 



or 



E;^EC &HCO00 ENTER ) 

which is the same address in hexadecimal. This is the 
first address of the Editor. You must use the decimal form 
if you have a 4K computer. 

Entering BASIC will empty your edit buffer. Re-entering 
the Editor wilt empty your BASIC buffer. 

Hints on Writing Your Program: 

♦ Copy short programs unreservedly from any legal 
source available to you. Then modify them one 
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step at a time to learn how different commands 
and addressing modes work. Try to make the pro- 
gram relocatable by using indexed, relative, and 
indirect addressing (described in Part 1 1 J. 

Try to write a long program as a series of short rou- 
tines that share the same symbols. They will be 



easier to understand and debug. They can later be 
combined into longer routines. 

Note: You can use the Editor to edit your BASIC 
programs, as weft as assembly language pro- 
grams. You might find this very useful since the 
EDTASM+ Editor is much more powerful than 
BASIC'S. 
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The command to assemble your text program into 
machine-code is simple. Just type (from the Editor com- 
mand level): 

A FILENAME gHTERI 

If your program is in memory, you will be prompted with: 

CASSETTE READY 



and when you press C ewteR ) your cassette recorder will 
start. You are assembling the object program on tape for 
use another time and place- The Assembler will display 

a listing to explain what it is doing. (See Figure 1 for an 
explanation of the listing.) 

While this is the simplest form of the assemble com- 
mand t it is not the one you will use first. You will want to 
make absolutely sure the program works before you 
assemble it to tape. 

There are several options called switches which you can 
use to assemble the program for trial purposes. You may 
use any combination of these switches. For example: 

A/I M/ WE 
A/WE'LP.'NS 
A TEST/LP 

are all acceptable assembler commands. 

/WE 

Wait On Errors Switch 

You will normally want to use this switch. It causes the 
Assembler to stop each time it encounters an error in 
your program. Press any key to continue the listing. 

/SS /NO /NS /NL /LP 
Listing Switches 

Use these switches if you want the assembler listing 
(illustrated in Figure 1) to appear differently: 

/SS Short screen listing 

/NO No object code in the listing 

/NS No symbol table in the listing 

/ML No listing at all 

■IP Listing printed on the printer 



IM 
Assembling In Memory Switch 

The program will be assembled in memory, not on tape. 
This is usually for a trial assembly. 

Where in memory? Used with no other switches, the 
Assembler will store your program just after the symbol 
table which is just after the edit buffer: 



EDIT BUFFER 
SYMBOL TABLE 



ASSFMRl. ED PHOGHAM U i ARTS ! !C^E 



08DQ 



TOP OF RAM 



■1FFFU6K) 
7FFFC32K) 



Figure 2. In Memory Assembly 

The edit buffer contains your assembly language pro- 
gram. It begins at hexadecimal address Q800 r and will 
vary in size depending on how long your program is. 

The symbol table references all the symbols in your pro- 
gram and their corresponding values. Its size also varies 
depending on how many symbols your program has. 

If you typed the sample program, you can try out an in- 
rnemory assembly. Make sure the program is in the Editor 
in its original form. Then, from the Editor command level, 
type: 

fl/IM .ENTER' 

(If you want another look, type ft/ 1 M over again. You can 
pause the display with SHIFT) (Wj and continue with 
any key. 3 

Since this sample program uses START to label the 
beginning of the program, you can find its originating 
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latsBirse 


Fff 


0013ET^TAI?T 


LOA 


**0F3 




30OZ be; 


050(3 


001 10 


LDK 


**5fl0 




0005 A7 


80 


00120 SCREEN 


STA 


,X+ 




0007 ec 


05FF 


00130 


DlPX 


»*5FF 




000A 2G 


F9 


B&140 




CD The location in memory where the assembled code 
wifl be stored. In this example, the assembled code 

for LDA #$F9 will be stored at hexadecimal location 
GOOD. 

® The assembled code for the program line. 86F9 is tine 

assembled code for LDA #SF9. 

<D The program line. 

@ The number of errors, if you have errors, you will want 
to assemble the program agafn with the .- WE switch. 

(D The symbols you used in your program and the mem- 
ory locations they refer to. 



Figure 1. Assembly Display Listing 
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address from the assembler listing. If you examine ft with 
ZBUG, you'll see that it has been assembled into memory 
beginning between 0800 and 0900. 

/AO 

Absolute Origin Switch 

This switch allows you to absolutely determine where in 
memory you want your assembled program to originate. 
To use it, you need to have an ORG instruction at the 
beginning of your program. 

Insert this line at the beginning of the sample program: 

0QE3B ORG t^FFin 

Now type: 

A/II1/A0 

If you use ZBUG, you'll see that your assembled program 
now boqins at location 3F00: 



EDIT BUFFER 
SYMBOL TABLE 



ASSEMBLED SAMPLE PROGRAM 



0800 



TOP OF RAM 



3F00 



4-FFFU6K) 
rFFF (32 K) 



Figure 3. /AO In Memory Assembly 

As you can see, the AO switch set the location of the 
assembled program only. It did not set the location of the 
edit buffer or the symbol table. 

II your ORG instruction has not allowed enough room in 
memory for your program, you will get a BAD MEMORY 
error, The assembler cannot store your program beyond 
the top of RAM. 

/MO 

Manual Origin Switch 

The manual origin switch offers you maximum control of 
in-memory assemblies, You can use it to assemble the 
program using the contents of these two memory 
addresses: 

■ USRORG (which contains the originating address of the 
assembled prog rami 

■ BEGTEMP (which contains 0600. This is the originating 
address of the edit buffer and the symbol table (which 
is 0800 minus 200.] 



By manually changing the contents ot USRORG and 
BEGTEMP, you'll be able to set the originating address of 
the edit buffer and symbol tabic as wall as the executable 
program, Since this procedure is somewhat involved, not 
everyone will want to use the /MO swatch. 

To change the contents of these memory locations, you 
will need to rjet into ZBUG. Save the pre gram you cur- 
rently have in the Editor first. This procedure will destroy 
the contents of the edit buffer. 

Then get into the ZBUG word mode by typing: 

Z (ENTER 
W l ENTETT 

and follow the procedures for setting USRORG or BEG- 
TEMP (or both of them). 

Setting USRORG 

On start-up. 00 FD points to the top of RAM. In this exam- 
ple, we'll change it to 2F0O. Type: 

fd/ 

ZFBB [ENTER! 

Now memory locations beginning with 2FO0 are pro- 
tected from EDTASM + and can be used for your assem- 
bled program. 

Setting BEGTEMP 

On start-up, 00FF points to 060C. In this example we'll 
change it to 2000. This will make room for high resolution 
graphics and data. Type: 

F r / 

:30B ekteri 

The address you put in RFHt^:,;, , . 

r a "page boundary" ta hexadecimal nurnbei ending in 00) 

- greater than 0600 

* at least 300 bytes less than the contents of USRORG 

Assembling the Program 

To get back into the Editor, type: 
GCBGG lEBTEff] 

Load the sarnpEe program and, if you inserted an ORG 
instruction, delete it. then type: 



a/im/mo [inter: 

This wiil assemble your program into the address you set 
for USRORG and BEGTEMP. If you followed our exam- 
ples above, this command will assemble your program as 
follows: 



15 




BEGTEMP 



USHORG 



EDIT BUFFER 
SYMBOL TABLE 



ASSEMBLED SAMPLE 
PROGRAM 



TOPOFRAMCfiK) 



"FCC 



2200 Cset by 
changing 
location FR 



2F0O (set by 
changing 
I motion FD) 
3FFF [1610 
7FFFt32K> 



Figure 4. .MO In Memory Assembly 

/NO 

No Object Code Switch 

Use this switch it you do not want to store any object 
code in memory or on tape. 



Hints on Assembling 

- Use a symbol to label the beginning of your 
program. 

■ Use the ORG instruction only when using the /AG 
switch Used with /IM alone or/lMMO. the ORG 
address will not be the program's originating 
address. The Assembler will use it to offset (add 
to) the loading address. 

- The /WE switch is an excellent debugging tool. 
Use it to detect assembly errors before debugging 
the program. 

' As your program library grows, it helps to use a 
different system of names to separate your TEXT. 
CODE, and BASIC files. For instance, you might 
want to use T. C r or B as the last letter of each file. 

* If you would like to examine the edit buffer and 
symbol table after you assemble the program, use 
ZBUG to examine memory locations beginning 
with address 0800. 
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5 /Debugging with ZBUG 



ZBUG has some very powerful tools for a trial run of your 
machine language program. You can use them to look at 
every register, every flag, and every memory location 
during every step of running the program. 

Before reading any further, you might want to review the 
ZBUG commands you learned in Chapter 1. We will be 
using these commands in this chapter. 

Sample Program Exercise 

In this Chapter, we'll use the sample program to illustrate 
the debug commands, If you would like to us9 it and have 
not typed it in yet, sec "Sample Programming Exercise' 1 
in Chapter 2. 

Then insert an ORG $3FfJQ instruction at the beginning 
of the program (reinsert it, if you deleted it] and assemble 
the program using the /AO switch. See the discussion of 
the /AO switch in Chapter 3 if you need help. Then enter 
ZBUG by typing ""'" from command level in the Editor. 



Display Modes 



in Chapter 1, we discussed four examination modes. 
ZBUG also has three display modes. 

We'll examine each of these display modes from the mne- 
monic examination mode. If you're not in this mode, type 
n (EifTE R . 

Numeric Mode 

Type: 

n center: 

and examine memory locations 3FQ0 through 3F0G. 
which contain your program. In the numeric mode, you 
will not see any of the symbols in your program (START, 
SCREEN, and DONE). All you see are numbers. For 
example, location 3F0A displays the instruction BNE 
3F05 rather than BNE SCREEN. 

Symbolic Mode 

From the command level, type: 
s mm) 



and examine your program again. ZBUG is displaying 
your entire program in terms of its symbols (START, 
SCREEN, and DONE). Examine the memory location 
containing the BNE SCREEN instruction and type: 

The semicolon causes ZBUG to display the operand 
(SCREEN) as a number C3F05). 

Half-Symbolic Mode 

From the command level, type: 
H (ENTER) 

and examine the program. Now all the memory locations 
Con the left) are displayed as symbols, but the operands 
ton the right) are displayed as numbers. 

Using Symbols to 
Examine Memory 

Since ZBUG understands symbols, you can use them in 
your commands. For example, both of these commands 
open the same memory location [no matter which display 
mode you are in): 

START/ 
3F00/ 

While either of these commands will get ZBUG to display 
your entire program: 

T START DONE 
T 3FB0 3F3C 

You can print this same listing on your printer by substi- 
tuting TH for T 

Executing the Program 

Before trying a trial run ot the program, be sure you have 
a copy of it. As we've warned you. a small bug in it can 
destroy everything you have in memory. 

You can run it tram ZBUG using the G (Go) command fol- 
lowed by the program's start address. Type either of the 
following: 
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5 / DEBUGGING WITH ZBUG 



CSTART .ENTER' 
G3F00 it«fpaf 



aAd the program will execute, filling part of your screen 
with graphics character number F9. If it doesn't do this, 

the program probably has a "bug" which is what the rest 
of this chapter is about. 

The e BRK to 3F0C or S BRK to DONE is 2BUG telling 

you that the program stopped executing at the SWl 
instruction located at 3F0C. ZBUG interprets your cfos 
ing SWl instruction as the eighth or final "breakpoint" (dis- 
cussed below). 

Setting Breakpoints 

If your program doesn't work property, you might find it 
easier to debug ft rf you break it up inlo smalt units and 
run each unit separately. From the command level, type 
X foffowed by the address where you want execution to 

break 

We'll set a breakpoint at location 3F05, the first location 
containing the symbol SCREEN To do this, type either of 

the following: 

X SCREEN ENTER; 
K3Ffl? I ETST£R > 

Now type gst^rt (JENTEft) to execute the program. Each 
Eime execution breaks, type: 

C :,|KJER 

to continue. A graphics character will appear on the 
screen each time ZBUG executes the SCREEN loop. 
(The characters appear to be in a diagonal line because 
2BUG scrolls to give you the breakpoint message. ) 

Type: 

D rUKTElt 

to dispFay all the breakpoints you have set. Type: 

Clfl (ENTER 

and the tenth time ZBUG encounters that breakpoint, it 
halts execution. Type: 

v UNTER' 

This is the command to delete (Yank) a breakpoint. A 
breakpoint number aFter the Y will detete the breakpoint 

at that address. Used with no breakpoint number, ZBUG 
wfff defete all breakpoints. 

You may set up to eight different breakpoints numbered 

D through 7, You may not set a breakpoint in a ROW 
routine. 



Examining Registers 
and Flags 

Type: 

R (UTTER 

Wha| you see are the contents of every register during 
this stage of program execution. (See Section tf for a def- 
inition of all the 6809 registers and IJagsJ 

Look at register CC (the Condition Codel Notice the tet- 
ters to the right of it. These are the flags that are set in 
the CC register. The E. tor exam pie. means the E Hag 
is set. 

Type: 

x/ 

and ZBUG displays only the contents of the X register. 
You can change this in the same way you change the 

contents of memory. Type: 

.ffiTERj 
and Ihe X register now contains a zero. 

Stepping Through 
the Program 



Type: 



Note the comma f - 



LDX #$500 is the next instruction to be executed. Th& 
first Instruction, LDA #SFD, has just been executes 
Type: 

R (EHTEH 

and you II see this instruction has loaded register A witi 

Fa To see the next instruction (LDX #5500) executed, 
type: 

t (Simply 3 comma) 

You may continue single stepping through the prograir 
examining the registers at wilf r until you reach the end 

you do manage to get to SWl. the last instruction, ZBUG 
wrff print: 

CAN'T CONTINUE 

which means it has reached the final step in the program 
fSWI causes ZBUG to stop execution. If you omit SV 

from your program, ZBUG will continue executive 
memory. ) 



1fl 




Transferring a Block 
of Memory 

Type: 
U 3F0O Q000 g CEHTEffi 

Now the first six bytes of your program have been copied 
to memory locations beginning with 0000. 

Saving Memory on Tape 

To save a black of memory from ZBUG, type: 

P TEST 3F00 3F0C 3F00 [INTER': 

When the cassette is ready for recording, press (Interi, 
This saves your program, beginning at memory location 



3F00 and ending at 3F0C. on tape. The last number is 
where your program begins execution. In this ease, this 
number is the same as the start address. 

To load TEST back into ZBUG, type: 
L test (EWTEft ) 

Hints on Debugging 

' Don't expect your first program to work the first 
time. Have patience. Every programmer has bugs 
in his new programs, and debugging is a fact of 
life for ail programmers, not just beginners. 

- Be sure to make a copy of what you have in the 
edit buffer before executing the program. The edit 
buffer is not protected from machine language 
programs. 



19 




6/ Using the ZBUG Calculator 



ZBUG has a built-in calculator that will perform arithme- 
tic, relational, and logical operations. Furthermore, it 
allows you to interchangeably use three different num- 
bering systems, ASCII characters, and symbols. 

This Chapter contains many examples on how to use the 
calculator. Some of these examples require that you have 
the same sample program assembled fn memory that we 
used in Chapter 5. 

Numbering System Modes 

ZBUG recognizes numbers in throe numbering systems: 
hexadecimal (base 16), decimal (base 103, and octal 
[base 3). 

Output Mode 

The output mode determines which numbering system 
ZBUG will use to print or output numbers on the screen. 
From the ZBUG command level, type: 

010 £kTEE 

and examine memory. The T at the end of each number 
stands for base 10, Type: 

OB CENTER) 

and you will see a Q at the end of each number. The num- 
bers are all base 3. Type: 

016 CENTO 

and you are now back in base 16. which is the default 
output mode. 

Input Mode 

You can change input modes in the same way you 
change output modes. For example, type: 

JIB CENTER) 

Now ZBUG will interpret whatever number you input as 
a base 10 number, For example, if you are in this mode 
and type: 

T £9152 491G2 fcRTEff) 

ZBUG will show you memory locations 49152 (base 10) 
through 49162 (base 10). Note that what is printed on the 
screen is determined by the output mode r not the input 
mode. 



You can use these special characters to "override" your 
input mode: 



BASE BEFORE NUMBER 


AFTER NUMBER 


Base 10 & 
Base 16 S 
Base 6 (a 


T 
H 

Q 



Table 1 . Special Input Made Characters 

For example, while still in the 110 mode, type: 
T 49152 $C010 CfHTIRl 

The "$" overrides the 110 mode, ZBUG, therefore, inter- 
prets C0 10 as a hexadecimal number. As another exam- 
ple, get into the 116 mode and type: 

T d315ZT C010 

Here, the "T" overrides the 116 mode, ZBUG interprets 
49152 as decimal. 



Operations 



ZBUG wil] perform many different types of operations for 
you. For example, type: 

CO00+25T/ 

and ZBUG goes to memory location C019 Cbase 165. the 
sum of C00O Cbase 16] and 25 Cbase ten). If you simply 
want ZBUG to print the results of this calculation, type: 

C000+^5T- 

On the following pages, we'll use the terms "operands," 
''operators;' and "operation," An operation is any calcula- 
tion you want ZBUG to solve. In this operation: 

1+2- 

"1" and "2" are the operands. " + " is the operator. 

Operands 

You may use any of these as operands: 

1. ASCII characters 

2. Symbols 

3. Numbers tin either base 8, 10. or 16] Please note 
that ZBUG will recognize integers (whole numbers] 
only 
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Examples: 

'ft- 
prints 41 , the ASCI I code far A. 

5TAflT= 

prints the START address of the sample program. (It will 
print UNDEFINED SYMBOL if you don't have the sample 
program assembled in memory.] 

prints the hexadecimal equivalent of octal 15. 

If you would like your results printed in a different num- 
berirn system, use a different output mode. For example, 
get into the O10 mode and try all the above examples 
again. 

Operators 

You may use arithmetic, relational, or logical operators. 
(Get into the 016 mode for the following examples.] 

Arithmetic Operators 

Addition + 

Subtraction 

Multiplication * 

Division ♦ D IV - 

Modulus , MOD. 

Positive + 
Negative 

Examples: 
DONE- START = 

prints the length of the sample program mot including the 
SWI at the end]. 

9«DIU.2= 
prints 4. (26 UG can perform only tnteger division.) 

3>HQD.2= 

prints 1, the remainder of 9 divided by 2. 

1-2 = 

prints OFFFR 655351 or T 777770, depending on which 
output mode you are in. ZBUG will never calculate a neg- 
ative number as a result. Instead, it uses a ''number cir- 
cle" which operates on modulus 10000 (hexadecimal): 






FFFD 



mmus i 
equate 2 
FFFF 1 

Figure 5, Number Circle Illustration of Memory 



To understand this number circle, you can use the cfock 
as an analogy, A clock operates on modulus 12 in the 
same way the ZBUG operates on modulus 10000. There- 
fare, on e clock, 1 :00 minus 2 equals 1 1:00: 



T1:0€ 



1:00 



{■■:<-: 



ZQd 




equals 
1 1:130 



1:00 



Figure 6. Number Circle Illustration of Clock 

Relational Operators 

Equals ► EQU- 

Not Equal -NED , 

These operators determine whether a relationship is true 
or false. 

Examples: 

5.EQU,5^ 

prints OFFFF. since the relationship is true. (ZBUG will 
print 65535T in the O10 mode or 177777Q in the 08 
mode.) 

5.NEG,5= 

prints 0, since the relationship is false. 



Logical Operators 




Shift 




Logical AND 


>AND< 


Inclusive OR 


. OR ■ 


Exclusive XOR 


.XOR* 


Complement 


.MOT. 



Logical operators perform bit manipulation on binary 
numbers. To understand bit manipulations, see the 6809 
assembly language book we referenced in the 

introduction. 

Examples: 
10<2 = 

shifts 10 two bits to the left to equal 40. This is the same 
operation the 6809 ASL instruction performs, 

10<-2- 

shifts 10 two bits to the right to equal 4. The ASR instruc- 
tion also performs this operation. 

6,tfOR.5= 

prints 3, the Exclusive Or of 6 and 5. The 6609 EGR 
instruction performs this operation. 
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Complex Operations 

ZBUG will calculate complex operations in this order: 



+ *DTV, .HuO, 

.AMD. 
♦ OR, ,X0R< 

+ - 

♦EQU, *HEO. 



You may use parentheses to change this order. 



Examples; 

The division is performed first. 

The addition is performed first. 

The multiplication Is performed first. 
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7/ Running the Program From BASIC 



The finished product of your labors is an assembled, 
debugged machine-code program. You can nun this pro- 
gram directly from BASIC as either a stand-alone pro- 
gram or as a subroutine to your BASIC program. 

The steps are: 

From the Editor-Assembler: 

1 . Revise the proqram so that it will run as a routine and 
return to BASIC 

2. Assemble the program on tape 
From BASIC: 

3. Load the assembled program with CLOADM 

4. Execute the program 

■ as a stand-alone program using EXEC, or 

• as a subroutine to your BASIC program using CLEAR 
and USR 

1 . Revising the Program 

Before you can use the program from BASIC, you need 
to make a minor change to it. Change rt to a routine 
which, after executing, will return to BASIC. 

In our sample program, the next to the last instruction is: 
SHI 

Load the program into the Editor and changy that instruc- 
tion to: 

RTS 

Now the program is actually a routine which you can run 
from BASIC. (If you want to execute it again from ZBUG, 
you'll have to change RTS back to SWJ or set a break- 
point before SWI and never execute it.) 

So that your program is the same as oum, be sure that it 
has an ORG $3F00 instruction at the beginning of the 
program. This is the revised sample program. 



DONE 



BNE 
RTS 
END 



SCREEN 



START 



SCREEN 



ORG 
LDA 
LDX 
STfl 
CMPX 



aiUFS 
*$5FF 



2. Assembling the Program 

Once the program is revised, assemble it to tape with this 
command: 

A SAMPLE UNTER: 

You are now finished with the Editor-Assembler, so you 
may start-up the Computer without the EDTASM I ROM 
cartridge or enter BASIC with the O command. 

3. Loading the Program 

To load the program, prepare your recorder and type: 
cloadm (Inter; 

Since we inserted an ORG S3FQ0 instruction in the sam- 
ple program, you did not need to specify where in mem- 
ory the program should be loaded. The program will be 
loaded at memory locations beginning with 3F00 (dec- 
imal 16128). 

If your program does not have an ORG instruction, your 
CLOADM command will need to specify a loading 
address. CLOADM^SOOO iE NTEFTj . for example, would 
bad the program into memory locations beoinnino with 
16000. 

4. Executing the Program 

You can either execute the program as a stand-alone pro- 
gram or as a subroutine. 

As a Stand-Alone Program 

Type: 

EXEC 161-28 l EHTER j 

The program will execute and return you to BASIC'S OK 
prompt. 



25 



7 / RUNNING THE PROGRAM PROIVA BASIC 



As a BASIC Subroutine 

This is the most popular way to use machine language 
routines. When you need to do a task which is too slow 
or impossible in BASIC, you can call a machine-code 
subroutine. When the task is completed, it will return con- 
trol to your BASIC program, 

Type and RUN this BASIC program: 

10 CLEfift 2B0i 151Z& 

20 DEF L3SR0=16128 

3G CLS 

AG INPUT "PRESS ^ENTEP V WHEN READY" i A4 

5ffl fl=USR(01 

60 INPUT "WANT TO DO IT AGAIN 11 ; ft* 

70 IF A*="YES" THEN 20 

RUN ©ITER 

Normally BASIC can use any memory locations from 
decimal 1 536 to Ihe top ot RAM. This means it could pos^ 
sibly overwrite your machine-code program. Line 10 
CLEAfls an area of memory from 16128 (which is hex- 
adecimal 3F00S to the top of RAM, thereby restricting 
BASIC from using this area, 

Line 20 defines the originating address of I he machine- 
code program [USR) to be 16128, Line 50 calls the 
subroutine, 

Passing Parameters 

If you want to send some data to your machine-code pro- 
gram Swe call this "passing a parameter - ] . you can sub- 
stitute the parameter" for the 0. For example: 
ft=U.S&*5> 



will call the machine-code program and pass the parar 
eter of 5 to it To get this parameter, your machine-codi 

program will need to have these two instructions: 

INTCNV E5U 1S3ED 

JSfi QIMTCNU] 

which calls a routine called INTCNV (INTCNV is locate 
in your BAStC ROM, along with other routines you cb 1 
use. All the 6 ASIC ROM routines are listed m Appenv 
£) INTCNV will get 5, the parameler in your USR state 

ment, and load it into the D register. 

Your machine-code program can, in turn, return a parsr 
eter to your BASIC prorjrarn by loading it in the D regitfc 
and then executing these instructions: 



GlWft&F 



JSR 



tCIMABF] 



GIVABF will set the variable in your USR statement, r 
this case A. equal to the contents of the D register. 

For more information on passing parameters, see ft 
6609 assembly language book we referenced in tn 
introduction. 

Note: to generate the I character, type :;SH^E3" M. 
To generate the I fypei SHIFT/ (jD- 

Hints and Tips 

* To save memory, use this formula to calculate the 
originating address of your program: top of RAN 
minus the length of the program (in bytes). 
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8/6809 Assembly Language 



This is a brief reference section on programming the 
6509 microprocessor. It will not teach you assembly lan- 
guage programming. 

Newcomers to assembly language programming will 
want to read: 

Radio Shack Catalog No, 62-2077 
by William Barden Jr. 

Others, who want more information on the 6809 for tech- 
nical applications, will want to read: 

MCG809-MC8809E 

8 Bit Microprocessor Programming Manual 

Motorola, Inc. 

The 6809 Microprocessor 

The 6309 Microprocessor is produced by Motorola, Inc. 
It is an enhanced version of the MC6300 Microproces- 
sor Programs written on the 6300 are upwards compat- 
ible with tne 6609. 

Registers 

The BS09 Processor contains nine temporary storage 
areas which you may use in your program: 



REGISTER 


SIZE 


DESCRIPTION 


A 


1 byte 


Accumulator 


B 


1 byte 


Accumulator 


D 


2 bytes 


Accumulator 
Ca combination 
of A and B] 


DP 


1 byte 


Direct Page 


CC 


1 byte 


Condition Code 


PC 


2 bytes 


Program Counter 


X 


2 bytes 


index 


Y 


2 bytes 


Index 


u 


2 bytes 


Slack Pointer 


s 


2 bytes 


Stack Pointer 



Table 2. 6809 Registers 

The 4 and B registers are for manipulating data and 
doing arithmetic calculations. They can each hold one 
byte of data. If you like, you can address them as D, a 
single two byte register. 



The DP register is for direct addressing. It will store the 
most significant byte of an address. This allows the Pro- 
cessor to directly access an address with the singEe. 
least significant byte. 

The Xand Y registers can each hold two bytes of data. 
You will use these registers primarily with indexed 
addressing. 

The PC register stores the address of the next instruc- 
tion to be executed. 

The U and S registers can each hold a two byte address 
which points to an entire "stack" of memory: This address 
is one plus the top of the stack. For example, if the U reg- 
ister contains 0155, the stack begins with address 154 
and continues downwards. 

The processor automatically uses the 3 register to point 
to a stack of memory during subroutine calls and fnter- 
rupts. The U register is solely tor your own use. You can 
access either of these stacks with the PSH and PUL 
instructions or with indexed addressing. 

The CC register is for testing conditions and seti rg 
interrupts. It is divided into eight "flags," Many 6809 
operations will "set" or "clear" one or more of these flags. 
Other operations will test to see whether a certain flag is 
set or clear. This is the meaning of each flag, if set: 

C (Carry), bit D an 8*bit arithmetic operation caused 
a carry or borrow rrorn bit 7. 

V (Overflow), bit 1 ■ an arithmetic operation caused 
a signed overflow. 

Z (Zero), bit 2- the result of the previous operation is 
zero. 

N (Negativel bit 3 - the result of the previous oper- 
ation is a negative number. 

1 [Interrupt Request Mask), bit 4 any requests for 
interrupts will be disabled. 

H (Half Carry), bit 5 - an 8-bit addition nperation 
caused a carry from bit 3. 

F CFast Interrupt Request Mask), bit 6 any 

requests for fast interrupts will be disabled. 
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E {Entire Flag], bit 7 all the registers were stacked 
during the last interrupt stacking operation. (If clear, 
only the PC and CC registers were stacked). 

The Assembly Language 
Program 

You may use four fields in an assembly language instruc- 
tion: symbol, command, operand, comment. In this 
instruction: 

tt-iFh! GETS CHAR 



START 



LDA 



START is the symbol. LDA is the command. #$F9 is the 
operand Cwe will discuss the meaning of the # and S 
signs later]. GETS CHAR is the comment. 

The comment is purely for your convenience. It is ignored 
by the Assembler. 

The Symbol 

You can use symbols to define memory addresses or 
data. The above instruction uses START to define its 
memory address. Once defined, you can use START as 
an operand in other instructions. For example: 

ENE START 

branches to the memory address defined by START 

The Assembler stores all the symbols, along with the 
addresses or data they define, in a "symbol table'' rather 
than as part of the "executable program." 

The Command 

The command may be either: a "pseudo-operation," or a 
6809 instruction. 

Pseudo-operations control various Functions of the 
Assembler itself, such as defining labels, tolling the 
Assembler where to store the executable program, or 
storing data in memory. They are not translated into 6809 
machine-code and are not stored with the executable 
program. For example: 

NArE EOU $43 

defines the symbol NAME as 4.3. This information is 
stored in the symbol table. 

ORG $30013 

tell 3 the Assembler to begin the executable program at 

address 3000, 

SYMBOL FEB *B 

stores 6 in the current memory address and labels this 

address SYMBOL SYMBOL and its corresponding 

address are stored in the symbol table. 



6809 instructions tell the Microprocessor to carry out an 
operation. They are translated into 6609 machine-code 
as "op codes" and stored with the executable program. 
For example: 

tells the Processor to clear the A register. The Assembler 
translates this into op- code number 4F and stores it with 
the executable program. 

All the pseudo-operations and 6809 instructions are 
listed at the end of this section. 



The Operand 



The operand allows you to specify a memory address or 
data. For example: 

LDD *$3B00 

loads register D with 3000. The operand, #£3000, spec- 
ifies a data constant. 

The S sign indicates that 3000 is a hexadecimal, rather 
than decimal number. You must specify hexadecimal and 
octal numbers with: 



BASE BEFORE NUMBER 


AFTER NUMBER 


HEXADECIMAL $> 
OCTAL (a 


H 

Q 



Table 3, Hexadecimal and Octal Operands 

For example, the Assembler interprets 1 7 as decimal 1 7: 
$1 7 as hexadecimal 1 7: and 17G as octal 1 7. 

The Assembler treats the operand as part of the 6609 
instruction. It stores the operand with the executable 
program. 

Addressing Modes 

In the above example, we used the # sign to tell the 
Assembler and the Processor to interpret 3000 as data. 
We can specify a different mode of interpretation by 
emitting the 4 sign: 

LDD taouia 

which interprets 3000 as an address. The Processor will 
then load D with the data contained in address 3000 and 
3001. 

Each of the 6809 operations allow you to use one to six 
addressing modes. These addressing modes tell you 
whether an operand is required to carry out the operation 
and which mode the Assembler and the Processor will 
use in interpreting the operand, 
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1, Inherent Addressing 

There is no operand, since the instruction doesn't require 
one. For example: 

interrupts software. (No operand required.) 

CLRA 

clears register A, Again, no operand is required. The A 
register is part of the instruction. 

2, immediate Addressing 

The operand is data. You must use the 4 sign to specify 
this mode. For example: 

ADDA w*30 

adds the value 30 to the contents of the A register. 

DATA EOU $6004 

LDK *DATA 

loads the value 8004 into the X register 

CMPX «t$1234 

compares the contents of register X with the value ?234. 

3, Extended Addressing 

The operand is an address. This is the default mode of all 
operands, f Exception: if the first byte of the operand is 
identical to the direct page, which is 00 on start- up. it will 
be directly addressed. This is an automatic function of 
the Assembler and the Processor. You do not need to be 
concerned with it if you' re a beginner.] For example: 

jumps to address 1234, 



SPOT 



EQU 



SPOT 



stores the contents of register A in address 1 234. 

If the instruction calls for data, the operand contains the 
address where the data is stored, 

LDA *1Z30 

does not load register A with 1234. The Processor will 
luad A with whatever data is in address T234. It 06 is 
stored in address 1234, register A is loaded with 06. 

ADDA $1234 

adds whatever data is stored in address 1234 to the con- 
tents of register A. 



LCD 



$1^3£] 



loads D, a two- byte register, with the data stored in mem- 
ory locations 1234 and 1235. 

You can use the > sign, which is the sign for extended 
addressing, to force this mode. [See "Direct Addressing"). 



Extended Indirect 

The operand is an address of an address. This is a vari- 
ation of the extended addressing mode. The I J signs 
specify it. [Use 1 shift: > )to produce the [ sign and ishift" 
(*] to produce the l sign J 

Jn understanding this mode, thank of a treasure hunt 
game. The first instruction. "Look in the clock." The clock 
contains the second instruction, "Look in the refrigerator." 

Examples: 

JSP Ct.12343 

Jumps to the address that is contained in addresses 
1234 and 1235. It 1234 contains 06 and 1235 contains 
1 1 , the effective address is 06 1 T , The program will jump 
to 0611. 



SPOT 



EQU 
STA 



$1234 
[SP0T1 



stores the contents of register A in the address contained 
in addresses 1234 and 1235. 

LDD [*123AJ 

loads D with the data stored in the address stored in 
addresses 1234 and 1235. 

This is a good mode of addressing to use when calling 
ROM routines. For example, the entry address of the 
POLCAT routine is contained in address AOOO. There- 
fore, you can call it with these instructions: 

POLCAT EOU $A«ZJE0 

JSP [POLCAT] 

!f a new version of ROM puts the entry point in a different 

address, your program will work without any changes. 

4. Indexed Addressing 

The operand is an index register which points to an 
address. The index register may be any of the two byte 
registers, including PC. It may be augmented by: 

■ a constant or register offset 

■ an auto increment or autodecr ement of 1 or 2 

The comma (.) indicates indexed addressing. 

As an example, well first load X. a two byte register, with 
1234: 



LDX 



s$t23il 



We can now access address 1234 through indexed 
addressing. This instruction: 

STA tX 

stores the contents of A in address 1 234. 



STA 



3 r , 
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stores the contents of A in address 1237. which is 1234 
- 3. C3 is a constant offset.] 

SVMBOL EOy ta 

5Tfl SVJ1B0L rtf 

stores the contents ol A in address 1238, which is 1234 

f SYMBOL (SYMBOL is a constant offset.) 



LDO 



a$5 



stares the contents of A in address 1239 which is 1234 
- the contents of B. CB is a register offset. You may use 
either of the accumulator registers as a register offset) 



STfl 



*X* 



This instruction does two tasks: ( l ) stores A's contents in 
address 1234 (the contents of X) and then C2) increments 
Xs contents by one. so I hat X will contain 1235. 

tl ) stores As contents in address 1 235 (the current con- 
tents of X) and then f2J increments Xs contents by two to 

equal 1237. 



5TA 



t - - n 



[1] decrements the current contents of X by two to equal 
1235 C1237 2) and then (2] stores A's contents in 
address 1235. 

As we said above, you can use PC as an index register 

In this form of addressing, called program counter rela- 
tive, the offset is interpreted differently. For example: 

SYMBOL FCB B 

LDA SYKflOL nPCJ? 

When this program is assembled, the Assembler SUB- 
TRACTS the contents of the PC register from the offset: 

LDA SYHBOL-PCR i«S 

When it is executed, the Processor ADDS the contents 
of the PC register to the offset. This causes A to be 
loaded with SYMBOL 

This appears to be the same as extended addressing. 
However, by using program counter relative addressing, 
the resulting machine-code program is completely 

relocatable. 

Indexed Indirect Addressing 

The operand f$ an index register which points to an 

address of an address. This is a variation of indexed 
addressing. For example, assuming that: 

* the X register contains 1 234 

* address 1234 contains 1 T 
- address 1335 contains 23 



* address 1 123 contains 64 
Ihis instruction: 

LDA C f X3 

loads A with 64. CThe X register points to the addresses 
of the address. This address is storing 64, the required 
data.) 

STA [ t 'Al 

Stores the contents of A in address 1 1 23. (The X register 

points to the addresses, 1234 and 1235. of the effective 
address. 1123.). 

5. Relative Addressing 

The Processor interprets the operand as a relative 
address. There is no sign to indicate this mode. The Pro- 
cessor automatically uses 1 fur aiS branching instructions, 

For example, if this instruction is located at address 
0560: 



r : ft n 



»p: as 



The Processor will convert $0600 to a relative branch of 
+ 5(0600 05S0), 

As we said above, the Processor automatically uses this 
mode on all branching instructions. It is invisible to you 

unless you get a BYTE OVERFLOW error, which well 
discuss below. Because the Processor uses this mode H 
you can relocate your program in memory without chang* 
ing any of the branching instructions. 

The BYTE OVERFLOW error means that the relative 
branch is outside the range of 128 to + 127. You will 
have to use a long branching instruction instead. For 

example: 

LBRA 



32768 to 



IflSfifl 

allows a relative branching range of 

+ 32767. 

6. Direct Addressing 

In this mode, the operand is haft of an address. The other 

half of the address is the contents of the DP register: 



ADDRESS 



OPR£Gf$TEfl 
(most significant 



OPERAND 

(least Significant 

byte) 



Figure 7. Direct Addressing 

The Assembler and the Processor use this mode auto- 
matically whenever they approach an operand whose 
first byte is what they assume to be e "direct page" (the 

contents of the DP register). Until you change the direct 
page, they both assume it is 00. 



32 




For example, both of these instructions: 

J5F? *0015 

JSft *1:5 

cause a jump to address 001 5. In both cases, the Assem- 
bler uses only 15 as the operand, not 00, When the Pro- 
cessor executes them, it will get the 00 portion from the 
DP register and combine it with 15. (On start-up. DP con- 
tains 0. as do all the other registers.) 

Because of direct addressing, all operands beginning 
with 00, the direct page, consume less room in memory 
and run quicker. If most of your operands begin with 12. 
you might want to make 12 the direct page. 

To do this you first need to tell the Assembler what you 
arc doing by putting a SETDP pseudo-operation in your 
program: 

SETDP U2 

This tell & the Assembler to drop the 12 from all operands 
beginning with 12. That is, the Assembler will assemble 
the operand ,L 1234" as simply "34" 

Then you must luad the DP register with 12. Since you 



can use LD only with the accumulator registers, yau will 
have to load DP in a round-about manner: 



LDD 
TFR 



**12 
BrDP 



Now the direct page is 12. rather than 00. The Processor 
will execute all operands beginning with 12 (rather than 
00) in an efficient, direct manner. 

The Assembler uses direct addressing on all operands 
whoso first byte is the same as the direct page. You can 
be sure that the Assembler uses it or help document your 
program by using the - sign, which is the sign for direct 
addressing. For example, if the direct page is 12: 

JSR <*i5 

jumps to address 1215. This instruction documents that 
the Processor will use direct addressing. 

Likewise, you might want to use the ■- sign to force 
extended addressing. For example: 

JSR >U215 

jumps to address 1215- The Assembler and Processor 
use both bytes of the operand. 
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This is a listing of all the pseudo operations and the syn- 
taxes you should use in typing them. Addressing modes 
do not apply to pseudo operations. 

Definition of Terms 

symbol 

any string ore to six characters long, typed in the symbol 
field. 

expression 

any expression typed in the operand field. See Appendix 
C, ZBUG commands, for a definition of valid 
expressions. 

Pseudo Operations 

END 

END expression 

Tells the Assembler to quit assembling the program. You 
can use the optional expression to specify the start 
address of the program. For example: 

END *3F0@ 

tells the Assembler to quit assembling the program and 
to store its start address, 3F00, on tape. When you 
CLOADM the program, you will not need to specify the 
start address. 

EQU 

symbol EQU expression 

Equates a symbol to an expression. For example: 

LOOP! EQU *3F00 

causes LOOP 1 to equal S3F00. You may use LOOP1 as 
data or an address. 

EQU is helpful for setting the values of constants. You 
may use it anywhere in your pron/am. 

FGB 

symbol FCB expression 

Stores an expression into memory at the current 
address. The symbol's optional The expression may be 



one byte long. For example: 

DATA FCB $33 

stores 33 In address DATA, 

DflTA2 FCB *33 + CCiUNT 

stores 33 - COUNT in address DATA2. 

FCC 

symbol FCC delimiter string delimiter 

Stores an ASCII string into memory beginning with the 
current address. The symbol is optional. The delimiter 
may be any character, For example: 

Th^LI FCC /THIS IS A STRING/ 

writes the ASCII codes for THIS IS A STRING in memory 
locations beginning with TABLE. 

FOB 

symbol FOB expression 

Stores an expression into memory beginning at the cur- 
rent address. The symbol is optional. The expression can 
be two bytes long. For example: 

DATA FOB $332" 

stores 3322 in address DATA and DATA f 1 . 

ORG 

ORG expression 

tells the Assembler to originate the program beginning 
with expression. For example: 

ORG *3FE0 

causes tne assembler to begin assembling the program 
at address $3FQQ. 

You may put more than one ORG command in a program. 
When the Assembler arrives at the new ORG command, 
it will begin locating program code at the new 
expression 

RMB 

Ft MB expression 

Reserves expression bytes of memory for data. For 
example: 

DATA RMB *0G 

reserves 6 bytes for data beginning at address DATA. 
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SET 

symbol SET expression 

Sets symfrrf to be equal to expression. You may use SET 
to reset the symbol elsewhere in the program. For 

example: 

SYMBOL SET J3500 

sets SYMBOL equal to 3500. Later in the program, you 

may reset SYMBOL; 

SYHftOL SET *«& 

now SYMBOL equals 4300. 



SETDP 

SETOP expression 

Tells the Assembler that the direct page will be expws* 
start. Example; 

SETDP f2fl 

tells the Assembler to set the direct page to S20 You 
must also load the DP register with $20. See Direct 
Addressing"' ror more information. 
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Definition of Terms 

Source Forms: 

This shows all the possible variations you can use with 
the instruction. Table 4 gives the meaning of all the nota- 
tions wo use. The notations in italics represent values 
you can supply. 

For example, the BEQ instruction has two source forms. 
BEQ dd allows you to use these instructions: 

BEQ $08 &E0 <EFF BEQ IA0 

Whereas LBEQ DDDD allows you these: 
LBEQ *CB3G LBEO &FFFF 

Operation: 

This uses shorthand notation to show exactly what the 
instruction does, step by step. The meaning of ell the 
codes are also in Table 4. 



For example, the BEQ operation does this: 

% (but only if), the zero flag is set branch to 
fifre location indicated by the program counter 
plus the value of the 8-bit offset." 

Condition Codes: 

This shows which of the flags in the CC register are 
affected by the instruction, if any. As you'll note. BEQ 
does not set or clear any of the flags. 

Description: 

This is an overall description, in English, of what the 
instruction does. 

Addressing Mode: 

This tells you which addressing modes you may use with 
the instruction. BEQ allows only the Relative addressing 
mode. 
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ABBREVIATION 



ACCA or A 
ACCB or B 
ACCA:ACCB or D 
ACCX 

CCR or CC 

DPP, or OP 

EA 

IFF 

IXorX 

lYorY 

LSN 

M 

Ml 

MSN 

PC 

H 
□ ' 

TEMP 
xxH 

SpOrS 



MFANING 



Accumulator A. 
Accuiriufator B. 
Accumulator D. 
Either accumulator A or 

[accumulator B. 
Condition code register. 
Direct page register 
Effective address. 
If and only if. 
Index register X. 
Index register ¥, 
Least significant nibble. 
Memory location. 
Memory im mediate - 
Most significant nibble. 
Program counter. 
A register before the operation 
A register after the operation. 
A temporary storage location 
Most significant byte of any 

location. 
Least significant byte of any 

location 
Hardware stack poinler. 



ABBREVIATION 


MEANING 


UsorU 


User stack pointer. 


P 


A memory focation with immediate. 




direct, extended, and indexed 




addressing modes. 


Q 


A rer-d-wr : 1[? modify argument with 




direct, extended and indexed 




addressing modes. 


O 


The data pointed to by the enclosed 




( 1 6 bit address). 


□tf 


8-bit branch offset. 


DDDD 


16-bit offset. 


# 


Immediate value follows. 


$ 


Hexadecimal value follows. 


[ ] 


Indirection. 


_ 


Indicates indexed addressing. 


' 


Is transferred to. 


/ 


Boolean AND. 


V 


Boolean OR. 


Q 


Boolean Exclusive OF! (XDR). 


— 


Boolean NOT, 


! 


Concatination. 


+ 


Arithmetic plus. 




Arithmetic minus. 


■: 


Arithmetic multiply. 



Table 4. Notations and Codes 
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Add Accumulator B 
into Index Register X 

Soii'ce Farm; AfiX 

Operation; FX ■ IX ► ACCH 



Add with Carry into Register 

Source Forma: AOCa P. ADCB P 

Opcralioii: R'i H . m i C 

Condition Codes: 

H Set If * haHf-cany * ocrvrgtied; clcinrod otnerwir 
N Set iff the tesuj is fiofcyeve.: cleared oJ^ernrtSfi 
Z Sel if the resuFl * 2<yo nleared Dlrwwrse 



Add Memory into Register 

Sou'M Forms: ADDA P. ADM P 

Operation^- !■: V 

Condition Codas: 

H Set i' I Kill cany is Qeneralijdi Cleared DlhunviSo 
H Set i( the- fesJI is fWflnrwe: cleared nthenv 
2 Set it lUe result is Bern, Cteflred Qiwmijw. 



Add Memory Into Register 

Source Form; AQDD P 
Operallon: H"- M i MM i 1 
Condition Code:, 

h fet dDMStarJ 

hi Set ■! hx' result is no£aJrve- cleared dhenqtse- 

Z Sel it tnc result is Jiino; cte&red: alhcrvnse. 



Logical AND Memory 
into Register 

Soupge Farms: ANpA P; ANDB P 
Operation: H"< R \ W 
Condition Codas: 

H foal alfectod 

N Set if 1h*5 result is negative; cteamd. otherwise 



Source F&rni: AKD^C s'** 

Operation: R'-IHW 

Condition Codes; AffecTed itfeording Co Pn» OQCTOtiDn. 



Arithmetic Shift Left 

Source Fo*ms: ASL CJ: ASLA. ASLH 
Operation: C- \ 



m i- 



b7 ■ hG 

Condition Cbdn: 

H UTdoF,1C0 

N Sri ir ihc result is negative, dewed olfierwse. 

Z Set ii the result is jraro; deareo otherwise. 



Condition Codes: fvul ijVctluL' 

Description: Arjri Ihn S-bfl uilsigntifj value inflfiCumulalDr B 
■"■.' MH ":: Ha X 
Addr eaafng Mode: WtefenL 



V Serf it an overflow is generated; rfearud otherwise. 

C Set M h carry is generated: cleared nihorwise. 
Description: Adds Ihfl contents of flle C tcaTry] b-1 and the 
memory byie mtoanfl.&t aocumutfldo/ 
Addreaamg Modes: Immrc&ate, EKlfnnded: Dimcd rndejted 



V Set if an overflow is gonoraren"; cSearecl otherwise. 

C Set if a carry is generated: cleaned ctfhnrwisa. 
Description: Adds the mL-mi^v Uvle mln an fyntl 
accumulator 
Addressing Modes: Immediate; Ottondjed. DtfflCf. frtteied. 



V Set if art oworllqw is. generated: deararj otherwise. 

C Set it a. carry 15 general: cleared otherwise. 
Description: Aod:s Hip lfr&il memory value into JI"hj IG-bil 
OC&«n*Ailor 
Addressing Modes: Irnmertrate; Extended: Direct: Indcjxrad 



2. Set if the result is 20m desired alherw.se. 

V Always cleared 

C to! affected 
DfiscrljjUon: ?^r1orms the togiciil AND ODr^fllion betwL-en 
Hie cgnhNits of DO nccutrulaJExand tv ctnterHftOf rrumwy 
\cKnt&r rvf mid 1 rirte reftuR is stored m (he aocwimFator. 
AOdreasIng Medea; !mmndia3E?; fCjtli-nJod. oireqt; Indexed. 



Logical AND Immediate Memory 
into Condition Code Register 



Deacripllofi: PerfrjfmR a logical AND between (he condition 

mde r«rjistcr anjj tna- ImmediBitie tJyle wncified tq the- 

Tfisti-jjciion una olaoea ihe resuM in the candftian tsade 

n^stcr 

Addressiing Mode: lrnmed>.ite 



V Loaded with thn resuh yr the occlusive- OR of Oifs 
six ono seven d the anginui operand 

C LoarJerJ wth hii severi ci the ongmal ooc^orxJ. 
Oeseripiloni Sfsiits ail trtsflf Iheopefand one place to rte 
toA. SH ; i; rp nf fOOOOd wrth 3 ren3, &t seven is shttled irflo 
the C Ccwry) bit. 
AdtfresnUig Wlodes: inhereni: EKtr^nded- Direct Indexed. 



ABK 



ADC 



ADD 
(8-Bit) 



ADD 

( 1 G - B i t- ) 



AND 



AND 



ASL 
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ASR 



BCC 






BEQ 



BGE 



BGT 



Arithmetic Shift Right 

Source Forms: ASR Q. ASRA: ASPlB 





1 




Qp«ra1ioo. 


— h 





w bo 

Condition: Codes: 
H Undefined. 
N Sal if 1he /CSljIL is negative: cleared otherwise 



Z Set it the rcsuH is oaro; cleared otherwise, 
v MrM needed 

C Loaded ™tn 51! 2£ro a' the original operand. 
Description; Shifts all bis ol 3he operand one place La hr: 
right. Bit se^en is h«ld constant. Ei? zeno is shifted into the 
C [carry) nit. 
Addresainq ModH: Inherent Extended. Direct: Irdexed. 



^C 



BHI 



Branch on Carry Clear 

Source Forms: BCC do. LRCC DDDD 
Operation: 

TEMP. Mt 

FFQ then PC' r PC i TEMP 



Branch on Carry Set 

Source Forms: BCS titf: LOGS DDDD 
Operation: 

TEMP- Ml 

II- PC 1 lhenPC'T PC 1 TEMP 



Branch on Equal 

Source Frjrm&: GEQ tftt LBED DODO 
Ope fi Hon; 

TEMPr Ml 

IFFZ i then PC- PC ■ TEMP 
Condition Cotter Not allectad. 



Branch on Greater than 
or Equal to Zero 

Source Forms: L3-SL oJ: LBGL DDDD 
Operation: 

"CVP- M 

IFF IN 'r- VI D than PC '+ PC -TEMP 
Condition Codes: Not atlected. 



Branch on Greater 

Source Forms: BGT Od. LBGT DDlJu 
Operation: 

TEMP- Ml 

IFFZ\IN- = -Vi U then PC- PC i TEMP 
Condition Cobles: Not affected. 
Description;- Causes a branch iF the N Crteflaiive) oil and 
V EDV*rftow) brt arc either bath sm or tioth dear and the 



Branch if Higher 



Source Forms: BHI dd; LB HI DDDD 
Operation: 

TEMP- Ml 

IFF I C v 7 1 then FO PC i TEMP 
Condition Codes: Not affected 
Description: Causes a pranch if the previous operation 
caused nether a carry nor a zero result When used, attex a 



Condition Cortes: Not affocied. 

Description: Tests the Stale Ol Irm G (carry) nit and causes :■. 

jmrch iF it is dear 

Addressing Mode: Relative. 

Comments: Equivalent to BUS dd; LBHS DDDD 



Condition Codes: Nc-1 a J 'Rctea 

Description: Tests "he state n' the C Scarry) Lh1 and causes a 

branch H it is set. 

Addressing Mode: Relative 

Commafiui: Equivalent to BLO dd: UBLO DODO. 



Description: Trs1s the slate of the Z (z«m) bit and causes 3 
branch if rt is srE. When used after a Subtract or compare 
operation, this instruction will b-'anch if 1he compared values, 
signed ar unsigned, ware, exactly 'In. 1 i^rne. 
Addressing Mode: Relative. 



Description: Causes a branch it the N (negative) bit and 1he 
V (cverf law) pit are eimtr both set or both clear Thai is. 
branch f trip gi^r Ol a valid twos complement rasuH is. or 
would or, positive. Wh*l used rt^rt a SUblract Or Compare 
operation on 1wu*j comp-nme.it values. th:s instruction will 
branch H the rey :iler w;;s graiitrsf 1ha.n W euual tc the 
memory opcrurd. 
Addressing Mode: Relative 



Z taeroJ bit is Clear. In other wards, branch if 1he sipn d a 
vald twUS uurnqlemenl resuh is. or would be positive and 
nol iflro When used after a SLjh3ract or compare operation 
on lwu:-i ccrroleTiRnl values, this Instruction will branch i1 the 
reg sler was greater thar 1he memory operand 
Addressing Mode: Relative 



subtract or compare Operation en ynsrfjned Oir^ary values. 

this instairton Will branch I "he register wa:i h jnnr ihan the 

memryy operand. 

Addressing Mode: Flelarive. 

Comments: Generally not useful after INC DEC. LD TST 

and TSTCLRCC-M ins4ructtona 
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Branch if Higher or Same 

Bounce Forms: BHS do"; LBHS DDDD 
Operation:: 

TEMP* Ml 

FFC then PC'* PC + Ml 
Condition Codes: Nat affected. 

Description: Tests the state of the C (cnrryj b1 nnd causes 3 
branch if it is clear. When used atler a subtract or compare 



en unsigned binary values, this instruction will branch if \bc 

register was higher than or the same- as thu memory 

operant!. 

Addressing Mode: Relative 

Comments: This is a duplicate assembly-language 

mnemonic lor the- single machine instruction BGC. Genera)!/ 

not useFul after INC'DEC. LD.-ST. and TS'ULR-CQM 

instructions. 



BHS 



Bit Test 

Source Form: Bl^ P 

Operalton: TEMP- R ,\ M 

Condition Codes: 
H Nat fiMectOd 

N Sal il the rcsuM is negative: r.p.wr-.r. otherwise 
Z Set iF Ihe rosuM is zero; cleared otherwise. 



V Always cleaned 

C f*n! affected. 
Description; Performs the logical AND ol the contents ol 
accumulator A or B and the onnteMs oF memory location M 
nnc modifier. '.Up. cnndilinn codes according y. The contents- 
ol accumulatcr A nr B and memory Iccation M an; not 
aFle^teC. 
Addressing Mode« Immediate, Extended; Direct Indexed. 



BIT 



Branch on Less than 
or Equal to Zero 

Source Form*: BIX Cf&. LBLC DDDD 
Operation: 



TEMP- VI 

!F-ZvLN- ; 'Vh 1 IhcnPC' 
Condition Codes: Net artuded. 



PC i TEMP 



Description; Cuu^lj a brarien il 1ho exclusive OR ut the N 
inugati^i] and V [OvurllQw) bits is 1 Or if 1hti Z (ze?0> bit is 
Set. That is. branch if the sign ol a vui d twu:, 'jurr-;j|crnnjr1 
result is, or would be, negative. When used alter a subtract 
ar comcane operaton. on twos camplenftcrM values, this 
instruction will branch i1 the register was less Itvin Or urjual 
to 1he memory operand. 
Addressing Mode: Helative. 



LE 



Branch on Lower 



Source Forms: BUD ctf; LHLD DDDD 
Dps ration: 

TEMP- Ml 

IFFC- 1 thenPC- PC i TEMP 
Condition Codes: Ncl affected. 
rAea-cnptiom lnr.tr. 1he state of the C (carry! bit anri causes n 



branch i1 it is set, When used after a su&tnact or compare on 
unsigned b-nary values, this instruction will branch if the 
register was lower than trie memory operandi. 
Addressing Mode: Rotative. 
Comments: This is a duplicate assemhly-innguane 
mnemonic t& 1he single machine instnxTticn BCS. Generally 
H01 uselul after IMG-DEC. LO.ST. .nc T£T C: RGOM 
instructions. 






Branch on Lower or Same 

Source Forms: BUS dci: LBLS DDQQ 
Operation: 

TEMP* Ml 

IFF fC v Zl - 1 then PC 1 - PC I TEMP 
Condition Codes: Not needed. 
Description: Cm.ses a branch iF the pluvious Operation 



caused uiif«r a carry or a zero result When used afler a 

subtract or compare oparaliOn oil unsigned bcilary values.. 

this instruction will b*arch \* fiu register was Iowlx 1han Or 

the same as me menKiry operand 

Addressing Mode: Relative. 

Comments: Generally not Liajfa' allcr INGDLC. LD SI. arid 

TSTCtRCDM instructions. 



BLB 



Branch on Less than Zero 

Sou/ ce Forms: BLT do 1 ; LBLT DEOD 
Opefttlon: 
TEMP- Ml 

IfTIN'-'Vl l then PC'* PC - TEMP 
Condition Codes: Not affectec. 
Description: Couses a branch il eilher, bu1 not both, of Ihe 



N (negative] or V (overflow) oiss is sel. Tia? is. aranch il Jhe 
sign of a vahd twos compie^cm resuii is. ar wcuic bo. 
in s-ove When used alter a sublracl & ccrrijaru openHon 
on (wos complement binarv values, this instructtin will 
txanch il the register was less than iTie mwnofy operand 
Addressing Mode: Relative. 



Branch on Minus 

Source Forms: EMI dd; LBMI DDDD 
Operation; 

TEMP^ Ml 

IFFN 1 then PC 1 - PC i TEMP 
Cwidlli&n Codes: Not affected. 
Dtscrleliwir Ti v sts thr- fitatfv of me N (negntive! 1 bit anc 



ceases a. brarczh if sjp.i. That is, branch if the sk]n of the twos 

complement result a negative. 

Addressing Mode: Relative 

Comments: When used n*ter an ope-rasion on sipped binary 

values this inslrucSion will branch if Trie nesull is minus It ■> 

generally orefeired to use ihe L6LT mslrudion aire' signed 

operations 



BMI 



4T 
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BNE 



E-PL 



BRm 



BRIM 



BOD 



UC 



CMP 

(8-Bit) 



Branch Not Equal 

Source Form*- BNE rtf. L R^F DDDD 
Operation: 

TEMP- Ml 

IFF Z-Q then PC'- PC I TEMP 
Condition Codes: Nnl arreted. 



Branch on Plus 

Snurcs FormE: HPL efef; L±5PL DDDD 
Operation: 

TEMP* MF 

IFF N - Q then PC"- PC \ TEMP 
Condition Codes: NaS aFFecled. 
Description: Tesls the s1a1e of 1hR N [negative] b1 and 



Branch Always 



Source Forms: ERA dtJ; 
Operation: 

TEMP- Ml 

PC- PC-TEWP 



LBRA DDDD 



Branch Never 

Source Forms; ERN dtf; LBRN DDDD 
Operation: TLVF- Ml 
Condition Codea: Not ntiecten 



Branch to Subroutine 



Source Forms; 


DSR 


tfrf. LB 


Dce ration: 






tewp- m 






SP'- SP 1 


(^C:. 


PCL 


SP'- SP 1 


CSPJ. 


PCH 


PC'- PC I TEMP 





Branch on Overflow Clear 

Sogfre Forms: BVC dtf; LBVC DDDD 
Operation: 

TEMP- Ml 

IFFV than PC'- PC -TEMP 
Condition Codes: Nc-1 affected 



Descrlplioni Tests Pic- Stale- uF 1he Z (7Rra3 biF and (SUS4S a 

brancfl if i1 IS Clear When used aflera subtract or compare 

operation on any binary values, this instruction will branch 

H the register ps. or would he. rral equal to ihe memorv 

oocranc 

Addressing Mode: Relative. 



pauses n branch iF t is clear. Tjwt a, branch H the sign 

ot the twos compsement result is posffcue. 

Addressing Mode: Relalive. 

Comments: When used after an operation on signed Binary 

o. :.if™i. r^is inglruction wi'lhrgnch H the result (possibly 

invalid) n positfv*. it is generally prafsrred to qsa 1F*j EK3L 

mstrucl'on aitf signed operations. 



Condition Codes: No' affected 
Description; Causes an unccinditionai branch 
Addressing Mode: Relative. 



Description: Doss not cause a branch Thin instruction is 
t?ssentiHlly b no operator:, but has a brt pattern logically 
rslatRri 1o branch always. 
Addressing Mode: Relative 



Condition Codes: Not affected, 

[>escription: The program ™ngn1er is poshed onto thy slack 

TFie pr<ngrarF counter is Fhen loaded •'* th the su"> ul 1hc 

p r ngmm courter and the offset. 

Addressing Mode- Relative. 

Comments: A relurr 4 rom SUOfOUlino tRTS) instruction is 

used to 'cve-se this process and must t*i Ihn lasl instruction 

executed in a suoroutme. 



Description: Tests the state 0' Hie V [uverllaw) bit and 
Causes a bmrrh if t is clear. Thai is. branch if the twos 
complement result was vsM. When used after nn operation 
on twos ccmpJement binary values, this instruction w ,m 
branch if there was no overflow. 
Addressing Mode: Relative 



Compare Memory from Register 

Source Forms: CMPA P. CMPB P 
Operation: TEMP' R M 
Condition Codes: 

H UnnefmRri. 

N 5f>1 iF lhe rRsu'rF is negative; cleared olherwige. 

Z $el if lhe trsl II is zuru: Cleared Otherwise. 



V Se1 ir an ovartlow iy getlSraJed; duarud otherwise. 

C Sul iF a boTcw is generaled: ^iL-urixJ c'F*jrwi:;i^ 
Description: CompftrRs the ajrlcriEa u1 memury lucalion 
lo ^he ccinlRnts aF tf>e speci'i£?d regis-1er and sels the 
appr^ipriale condition codRS. NpithRr memory location M nor 
Ihe speni'ied register is madifiRd. The carry flag rRpresRnts a 
bnrrnv/ ard is set to 1hR inverse oF the resuHinc, bin^rv rarry 
Addressing Modes: mmrxJirUe; EntendRd; Direct; Indeed 
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Compare Memory from Register 

SoUfM Forma: CMPO r>\ CMPX P; CMPY P; C*vlF\l P- 

CfcPSP 
Operation: TEMP- Fl M'M j 1 
Condition Codes: 

■ I Mot jFfectCd. 

N Eel if the r osufl is negative; cleared OEFierwisR 

Z Se( iF |he result is zero; cleared Otherwise. 

V Set if an Overflow is generaled: cletrud olherwise 



Complement 



Source Farms: COW Q. COMA; COMB 
Operation: M'^ O h M 
Condition Codes: 

H to: aNoctod. 

;*J Set il 1f=t; 'ULiu'l is negative; cleared Olhervriie-. 

Z Sci il Ihe reSuft is rem; cleared otherwise. 

V Always Cleared. 

C Always ML 



C Sel if a borrow is f>epurared; cleared Otherwise. 
DeHcrlpEbon: Ccrnpjirfls the J&-tHt contends c-1 the 
COTcaleratetf memory lomhonsM^ r I To the contents 
n.1 he sceciliud -Mgintf 1 ' in. I ■,!;■:; ihr arjpiOL-ule mnclilion 
caries. Neither 1he memory locations nrjf the specified 
register is n^diFied unless auloincrement Or autoriecremon:l 
are used. 1 he carry flam represents a DOrruw and fs set 10 
the inverse el the resuming binary carry, 
Addressing Modes: Immediate; Extended; Direct; Indeed 



D&scription: Replaces (he contents uF memory location M 
or accumulator A orfl wfth its fiogidal complement. When 
operating nn unaigneQ values, Cnly BED and BNE branches 
can he ejipeded to behave properly following a COM 
'lsiruelion. When operating DM twos complement values. 
all signed branches n.re available. 
Addressing Modes: Inherent Extended; &rect: Indeed. 



CMP 

( 18-Bit ) 



COM 



Clear CC bits and Wait 
for Interrupt 

Source Form: CWAI #$XX 

Openalton; 

CCR- OCR A Mi iFossibay dear masks} 
Sel E (ensire stale saved] 



E f h I n z v c; 



SP 1 . 
SP 1 - 

SP'* 
£P'* 
SP"* 
SP'* 
SP- 
SP'- 
SP'- 
SP- 



SP 
SP 
5F 
SP 
SP 
SP 
SP 
SP 
SP 
SP 
SP 
SP 



CSPS 
(SP]- 
[SP]- 
(SP> 
(5PJ« 
(SP]- 
(SPJ- 
[SP). 
(SP)- 
tSPJ- 

cap> 

•'SP^ 



PCL 

PCH 

USL 

UShr 

l¥l 

IVK 

IXL 

IXH 

DPR 

ACCB 

ACCA 

CCA 



Condition Codes: AFFecEed according to the operation 



Descrlpliofl: This instruction ANDs an immediate byte with 
the coric tor" code register which may clear the iPterrapL 
mask bits f and F, slack* lhs Entire machine Stale on tlte 
hardwatu stack and then looks frxan interrupt. When a 
nco-maskud interrupt occurs, no further machtfie slate 
information need be saved before vectoring to the inter rupl 
handling routine. This nstruction replaced the MOfMOD OLI 
WA sequence, m.1 nVies no1 place 1he buses in a high- 
-pedance .tfate. A -\rt& L 4 ast interrupt T equest) mey ^ner 
i1s inlErnjpt handler *Hh its entinD mattiine state saved. The 
RTI trelum !mm inlemjpt) instructien wilF automatirnlly return 
ihp entire machine state after lesting the E (entire] hit of |he 
recovered condifion code register. 
Addressing Mode; infimediale. 
Comments: The feltivving immediate values will haw; the 
following resulia: 

FF enabJe neithE? 

EF - enable IRQ 

BK Erate RRO 

AF- ennhlE bnEh 



CWAI 



Decimal Addition Adjust 

Source Form: DAA 

Operation: ACCA". ACCA + CF(MSN):CRLSN) 

where CF in a CorrecJion Factor, as toUOwti. the Of- 1ur each 

nibble (.BCD) diflit is fletcnnined scparalelv. and s either 

bOfO. 

Least Significant Nibble 

GRLSNJ GIFF UC-1 

or2)LSN -9 
Most Sigrif icanl Nibble 
CFIMSN] 6 IFF 1 ) C 1 

or?JMSN -9 

or 3} MSN -eartfLSN -g 
Condition Codes: 
H Not affected 



H Sat iF the result is negative: cluarad alherwise 

Z — Set it Etie result is zet o: cleared otherwise. 

V Undelined. 

C Set it a carry is generaied d-' iF 1he carry bft was set 
before the operation: cleared DthRrwise. 
Description; The SCQuenue dF a single- hyte odd instruction 
on ncn. -jln:cr A toiler ADDA or ADCA) and a taliawing 
decima; adMon adjust instruction resuHs in a BCD addition 
wth an aopfoaratc carry bit Brjth values to be added musl 
be *1 proper BCD 1orm (each ribtile such (hat: 0- nibhle- 9) 
Muitjple-precision addition must add the carry generated by 
this decimal acdi!ion adust into the nest higher digit during 
the add operation (AIXA] immediately prior to the nexl 
decimal addition adjust. 
Addressing Mode: Inherent. 



DAA 
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DEC 



EOR 



P "■-■■ I " 



IN 



JMP 



J BR 



t 1 <=■ 

y i.J — 



LD 
it) 



Decrement 



Source Forms; DEC O; DECA: DECB 
Operation: M " ■ V 
Condition Codes: 

H Not affected. 

N SeI iF Ihe result is negative; c 'jarud otherwise. 

Z SeI iF 1he rusult is zetd; cfearuri otherwise. 

V SeI iF Ihe original operand was IDOQODQQ: cleared 
otherwise. 



C Not affected, 
Description; SeDtract one Irom (he operand. The tarry hit 
is nci affected, thus allowing ihis instruction to be jsed jl; 
a bop counter n mulliple-pfeasiDn compulations. When 
operating on unsigned values, only BEQ and SNL branches 
can be expected to ucnave consistenlly. WWwi operating or: 
twos mmplMMrtl values, all signed branch** are available. 
Addressing Modes: Inherent; Extended: Dined; Indexed. 



Exclusive OR 



SourtE Forms: LQHA R EQRB P 
Operation: R'- R'F-M 
Condition Codes: 

H Not affected, 

N Set if lhe raault is negative: cleared otherwise. 



7 Bet H the result is zero; clEared otherwise. 

U Always ciegrari. 

C Not alfected 
Description:. The contenls ot memory location M is 
rx^Ii i?;ive ORed into .vi S-bil register. 
Addressing Modes: ImmEdiiVe. Emended; DiTEct; Indexed. 



Exchange Registers 

Source Fo*m: EXG R1.R2 

Operation; R1--R2 

Condition Codes; Net arretied [unless one of the registEr^ 

s thu condition cede regfeter) 

Description: Exchanges dala between 1wc- desigrmtnd 
regisl&fa. Sits 3-0 t>1 the pcslbyfe doFino one register, while 
b'ls 7 -A di:fin' Ihi: ;;:h'r. :i\- fellow?;: 

ODOO A:ti 1000 = A 

0DQ1 X 1001 -B 



0010 Y 

0011 US 
01 DO- SP 
01 D1 PC 
0110-Undelined 
01 11 - Undefined 



1D10-CCR 
1Q1T-DPFI 
1 100 Undefined 

1 iai -Undefined 
n 1 n Undefined 
1 -11 Undefined 



Increment 



Source Forms: INC □; INC A I NCR 
Dob ration: V- M ■ 1 
Condition Codes: 

H Not affected. 

N Kef ;f the rebuff i$ ne.jjative: cleaned Otherwise. 

7 Set 1 rhe result is zero; cleared otherwise. 

v" Set t the original operand wag 01 1 1 1111; 
deaned rtfherwise 



Jump 



Source form: JMP EA 
Operation; PC- EA 
Condition Codes; Not affected. 



Jump to Subroutine 

Source Form: JSR EA 

Ops ration: 

SP'-SP 1.ESP]*FCL 
SP 1 * 5P 1. (SP1* F"CH 
PC- EA 



Load Register from Memory 

Source Forms: LDA JP; LDB P 
Operation: Rr w 
Condition Codes; 

H Not anecled. 

k Set : I tl ie loaded data is •■ legarfiya; cleared 

ultiL'rwi^u 



Only like size registers may be exchangee (.B Pit wi!h 
a-btor 16-hitwith TS-bit.l 
AddTEsaing Mode: Immediate. 



C Not affected. 
Description; Acds to the operanc The carry ail is not 
affected, thus aliening this instruelien 10 be used as a taop 
ecunter in multiple-precision computations. When operating 
rjn unsgncd vaJuCS. enly the BLQ arid UNL branches can be 
CiipectCd to behave consistently. Whun opsrating sn t-A^i^ 
COrTiplumunL values, all sigrwd branchRS nrf! romecMy 
avaikjb 1 ^. 
Addressing Modes: hhcreiiV ExtHnded - Dirflct lndes,«c 



Descrlplion- Prcqram contf ol is Iranslerned 10 tne etleotive 

address 

Addressing Modes: Extended; Direct; Indexed. 



Condition Codes; Not 3+lected. 

Oescription: Prc-aram confoi =s iranslemed to the effective 

address alier stonncj the return address on the hardware 

stack A RTS inslruction should be ihc last executed 

Irtslruetien or Iht: ^ubroutir'j. 

Addressing Modes: : _\lendfd; J'-ecl. InOCKed. 



Z Set il It'j lu^idad data is zero; clEfueri otherwise 

V Always clears. 

C Not atlectEd. 
Description: Londr. thn conlents o-1 memory location M into 
1he dEsignriled register. 
Addrss&ing ModE&: Imm^r: irr;. EAtontled: Direct; indexed. 
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Load Register from Memory 

Source Forma: LPD P. LDX P\ LDY P; LDS P: LDU P 
Operation: FT- M:M + 1 
Condition Codfifi 

H No! affected 

N Sel if 1he 'oadcc data is negative: cleared 
otherwise 



Load Elf ective Address 



Source Forms: LEAX, LEAY, LEAS, LEAU 
Operation: Fi- EA 
Condition Codes: 

H htat afteded. 

M hiot affecterj 

" LEAX LEAV; Set F the result is zero; cleared 
otherwise LEAS LFALJ Npl alteeted. 

V Nat aftected 

C Not affected 
Deacr [ption: Calru ates the elf ective address torn the irtde* 
.indressirjg made anc places ihe address m an inducible 
register. 

LEAX and LEAY offset lhe 2 tiero) btf to Bltaw use or 
these registers as cnunters ond fey MCbiiOQ INX'DLX 
compatibility 

LEAU Hnd LEAS fin nol effect the Z Oil to allow Cleaning up 
the stack while retjrr ng ihe Z bl OS a parameter to a calling 



Logical Shift Left 

Seu'w Forms: LSL D\ L5LA; LSLB 



Operation: C- 



:j0 



b7 

Condition Codes: 
H —Undefined. 

N Sat rf the result is negative: Cleared olherwise. 
Z Set 1 the result is zero: cleared Olharwise. 



Logical Shift Right 

Source Forms: LSR Q\ LSHA. LSRR 
Ope re lion: 



D.| 



: 



._ 



h7 
Condition Codes: 
H Nat effected 



m 



Z — Set I' the loaded data is ?em; cleared Otherwrse. 

V — Always cleared. 

C Not affected. 
Descriptions Load me contEnLs a* tne memory location 
M;M - : into the designated iG-hit register. 
Addressing Modes: Immediate; Extended; Direct; Indexed- 



routine, and also tor MCSSOC- INS-'DES- uumpatibtJity 
Addressing Mode: Indexed 

Comments: Djh tu the order tfl whicFi affective addresses 
ore tatulaled intefnjiily, the LEAX. X I ■ and LEAX.K \ do 
not add 2 and 1 [respertiuely} j u ipa s register tut instead 
leave the X register unchanged. This a?sa applies to the 
Y. U, and S registers Fry lha uxpectec renuTS. use t*ie 
lazier istn-ctan LEAX 2, X and LEAX 1. V, 

Seme examples oF LEA instOJCttor uMS are given in |he 
following 'labln. 

Comment 

Adds 5-bit constant I (J ti i* 

Adds 1S-hil constant 5DD 10 X. 

Adds 3-bit accumulator «Q V. 

Adds 16-ai! D accumulator to Y 

SublractS lOfrc/nU. 

Used to reserve area on stack. 

Used to clean up stack. 

T'nrsterg os well us adds. 



instruction Operation 


LEAX 


10, X X-TfJ X 


LEAX 


500. X X - 500 X 


LEAV 


A. Y v ^ a - V 


LEAY 


D. Y v . o Y 


LEAU 


10. U U 10 U 


LEAS 


lfJ. S S 10 S 


LEAS 


10. S S* 10 3 


LEAX 


5 S Si 5 X 



V 



LoaCeo with the resuM Dl the exclusive DR of bits 
r,ix .inc seven el the or g.'iul operand. 
C Loaded with bii seven u* the origirol npor.nn: 
Description: Shifts al! fr-te ol ac^ur- jhilor A rs- fi or memory 
location M ane place to the left. Bit zero is a.ndcd with 
zero. Bh seven of accumulator A or B or memory location M 
is shifted -ate the C (carry] bit. 

Addre«lng ModftS; Irlherenl: ExSeafieC: Direcl: IrXlexed. 
Comnwrrts: T*tis is a dLiplicate assembly ianguuye 
mnemonic lor Bie Single machine instn^ction A3L. 



N Alw;i/F- rilegred. 

I Bet H the resuH is Dfiru; clEared olherwise. 

V Nk>1 affected. 

C Loaded with bit 20rO oF the original operand. 
Description: Performs logical shift righd on the operand. 
Bhi'ts .-. zero into bit seven and bit 7e?D into the C [r:a r r\0 hit 
Addressing Modes; Inherent; Extended Direct IrxJewed 



(1B-8U) 



LEA 






LSR 



Multiply 



Source Form; F^UL 

Operation; ACCA'iAOCS 1 ' ACCA vACCB 

CoridHSo#iCodra; 

H Nol ai-FuL-ted. 

N Nol affected. 

Z — Sel if 1Fie Teaurt is rero; cleared othenwi^e. 

V Nut aFlectec. 



C Set il ACCB hit 7 oF result is set; cteared otherwise. 
Description; Multiply the unsigned tyiary numbers m 1he 
accumi;laLors a.-id place ihe result in both accumulator's 
tAOCA comains the most-sir^nificant byle dF ihe result). 
Unsigned multiply allows multiple-precisian ooeralions; 
Addressing Mode; Inherent. 

Comments: The C fcgny) bH allOv/S rounding trie mosl 
Significant byte through the sequunce: MUL, ADCA #0. 



MUL 
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NEC 



Negate 



NOP 



OR 



Soure* Forms: NEG 0. NEGA; NLGB 
Operation: y. C 1 M 
Cond ilron Cotfoi: 

H Undefined. 

N Sei if jhe wsutj is nenaiMi clewed uihcfwtso 

Z Set it fie rkhr.ulr s jefcr Cleared plfifirwi-ji.'. 

V Set ,1 me ordinal uperard wati ICCIOGQQO. 



No Operation 

Soured Form; NOP 
Operation: fra( affected 



OP 



PSHi 



Inclusive OR Memory 
into Register 

Sou' C* Form* OKA P OflB P 
Operation; ft - Ft << V 

Condition Codes: 
H Hut atiected. 

N Set H rhR result is OtiflallTO; Cleared plfKKWi^ 



Inclusive OR Memory Immediate 
into Condition Code Register 

Source Form; OBCC mXX 

Operation: R < R ■<> M' 

CondJlkm Cedes: AHiiCtM needing lo Ihe QflwflHon 



Push Registers on 
the Hardware Stack 



PSHU 



So urcfl 


Fonm; 








PSHS register idf 




PSHS it LABEL 




P&SSbyta: 




b7 bS bt 54 os dz tii do 




PC 


U 


V 


X 


dp! b A fix I 




DOS*! OflJW ■ 




Operation: 




IFF b? o( posJbyle s«l. ihen: 5P ■ SP 


1.(SP). PCL 


SP"- SP 


t,($Pj. PCH 


IFFbSd bostbytE hlI. men: SP'- SP 


T.tSPV USL 










SP'- SP 


l. <SP>- USH 



Push Registers on 
the User Stack 

Source Form: 

PSHU agister !*t 
FSHU tHASUl 
Poslbyle 

b7 tffi b5 M b3 W bt M 
|PC| LI | 7 



j DP | B 



^L. 



yuan, nrder - 
OperaiikMt: 

IFF b7 ol poedbytesel, then: OS'- US 

US'- US 
ifF W3 01 posibUe set, (hen- US'- US 

us ■ us 



I.IUSJ* PCL 

l.tLJSJ.. PCH 
1, (US*. SPt 
1. [US* SPH 



SrI <r a bCro* « QCnffaled. drsared ovwrwjse 
Description: Replaces (ht? operand wi{H its Mttt 
comnlement. The C (c^rrvJ bit n-nre?si!i'1o 3 borrow :ind js set 
to asj inverse ol tho resutjiiig Ivtary cany J^ c INal W t «i 

recfacid by itseir and onty jr. this ce« is me v (medico* bit 
set Tho vaiufl oo.. is. giso reoJaoed hy dsdr. and only iniha 
case in the C (carry} bit ^Tirarecf 
Addressing Mod**; Inhnrenl: GKtendiiti: Direct 



Condition Codes: TTiis instruction causes only the prugrfjm 

COtdKtrtD bB Jncienienfki NODthE-r rirgislefgcrmrimorv 

bcAllonsanBaftectad 

Address ing Mode: Inherent 



^It'ifi-d :ih.-i ,v:-.i 



Z Set if the ?E5ult i$ 7Rra: 

V AA*ayS Cleared 

C *H arfecmd 
D«crlption: Performs a/i Incluiltfa OR operation ontween 
(tie CCrtem* ol accumulqlof Acr B and Ihe contorts of 
mernory bcaAon W and Ibe result is stored in occurnutaJor 
Aot& 

Addressing Modcg: tinmcfiialn- Ertundetf; Direct tntte»ll 



Description: PMorms zm inclusive OR opsr,'H>Dr, ooiweeri 
Ifte confent^i qP lho OcndrUon code regtsTcrs ;irnJ l?» 
Tmmodiate vnlue. dnd thH rcsull 15 pJzKusd m ttie Condition 
COdP (fgfflt*- TT^tfl mstructiOrt fnrty be used to set mteovot 

mnsks CCiMWe m!ivrvp^J Df any nlher bids I 
Addressing Mode: l^mprJiHte 



1, 



ISP)- IYL 

(SP*. I¥H 
(SP*. (XL 
fSPh r^h 

[&P1- DPR 
1ST 1 :- AOC0 



IFF b& ol pos&yte ^a. than SP ■ SP 

SP'- SP 
IFF M df po^bytc sal Ihe** SP ■- SP 

FFb3ofposlbylesoMr*en SP- SP 

t^ d2 rt oosttmt' sot, . ih«i SP'- SP 

tFF bT or postflyte sm. then: SP 1 - SP 

iFFbQolpostJjytE-sci then- SP 1 - SP 1, CSFVCCfi 
Canrfilion Co4«4: Not affected. 

Description: AM. SOms, & neon ol the prncrMwor rogisters 
arefcisned onlo fn*> hardware ftUx&ivrth lh« encnorionqf 
;he hufdwflm aiack potntftr imffl 
Addressing Mode: Immoihatc 

Comments: A aifflfe regi^le!' mffy be fttx&i do Iho stack 
with the CCOdHion coden act by dining Jin iiutndeCDmeJit 



1, (USJ> 

1 (US!. 

I. (US*. 

(US)- 

(US1- 

(US> 



l_ 

IVH 
IXL 

rxH 

DPR 

ACCB 

■m;;i,:a 



iFFO&ofposTbytesei. then. US • J 3 

US - - US 
FF t>J 0! paslbytesei. then. US 1 - US 

US'- us 

If F Mi 0* posibvte stL then; US'- US 

IFF tt2 Q- pustOytR stft. trw-n, US ■ US 

IFF bt Ol poslijytP sui ttien; US'- US 

IFF bd cl poabyte sj)|. Itieo US - US i.lUSI-OCFt 
Condition Codea: Not afrected. 

DescppllOni: All. some, or tionit D | ]hfl processor rugisler; 
are pushed onic the u&er slacX (wrth ne excepian ol Bw 
user pt^ck pointar IsselfJ. 

Addressing ModK ErnmediQlC 

CammentBJ A single rcfjister may be placed on 1N; .^LkK 
wrth ihe condition tudes set by doing an auledeerptmeni 
stare onto Vw SlflCh tfij«ampte. STX. Ul 
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Pull Registers from 
the Hardware Stack 

Source Form: 

PULS register rVsr 

PULS w LABEL 

F-astrjytc: 

_b7_ b6 b5 b4 _ba ttf bl bO 

\pc\ u fv [. kJop 



'J 



|CC 



. pull order 
Operation: 

IFF bO or poslbyte set. then: CCR' *■ iSPi. SP'. HP ■ 1 
IFFbl at coslbyte set. Ihen: ACCA'« IBPI. SP'- SP ■ 
IFF b2 u! poslbyte set. Ihen 
IFF b3 05 ptretbytc set, ihen 
IFF ba n1 postsytti sut, then 



ACCB - (SP). SP 1 - SP - 1 
DPfl 1 - (SP). SP'-SP- 1 
IJCH" < (SP), SP' 



C^L 1 



sp- 1 

tSP>, 5P 1 * 5P-M 



IFF t)5 nF postnyte sel, th&n: IYH' 


■ (SP], 5F 1 - 


SP < 1 


IYU 


< (SP], 5P'h 


SPh 1 


IFF nfi of pnsttiyfe sel. then: LJ5H' 


- ISP1. BP 1 - 


SP i 1 


USL' 


- [SP], SP'- 


SP + l 


iff ^/ of postbyte set ttwn: PCH' 


. (SP), SP'- 


SP ■ 1 


PCL 


. (SP), SP"' 


SP ( i 



Condition Cooes; May be puled from stack, not affecled 

otherwise. 

Description: All. some, or none o( the processor rsglsMts 

urc pulled I rem the hardware slack (with the exception o' the 

hardware sLaok pointer i1S3lf J. 

Addressing Mode: lrrirriE?d!-Latt]. 

Comments: A single regtstur rnafy bu pulled From 1he stack 

with nonditian codes sat by doing an autuincrement bad 

From (he stark texample: LDX.5 i \ ). 



PUL C 



w, 1 



PuJI Registers from 
the User Stack 

Source Form: 

FULU negater rV.TJ 

FVIU #LABEL 

Postbyte: 

or" bo" bb OJ n: : , t^ hi on 



PC 


J 


V 


X 


DP 


e 


A 


cc 



<- pull order 
Operation: 

IFF bO oS poslbyte set. (hen: CCR 1 
IFF bi of poslbyte set. then; ACCA' 
IFF b£ of postbyte set. then: ACCB 1 
IFF by of poslbyte set. then: DPR' 
IFF b4 of poslbyte set. then: IXH' 

IXL 



CUTS* US 1 - 
(U5>. US'- 
(U&>. US'- 
fU5>. US'- 
<US>. US'- 
(US*. US'- 



us 
us 
us 



US+ I 
US. I 
US i 1 



IFF b5 of pnstbyle set, Ihen: 



IYH' 
IYL' 



♦ (US). 

♦ (US), 

♦ (US], 
- (US). 

♦ (US). 
■ (US). 



US'-US t 1 
US'- US- 1 

us- us- ■ 
US'- us- ■ 
US'- US' i 
US'- US^ t 



IFF b3 01 postbyle set, 5hen- SPH' 

5PL' 

IFF b7 ol postbyle set, Ihen PCH 

PCL 

Condilion Codes 1 : May be pulled From stack; not affected 
otherwise. 

Descriplion: Al!., some, c? none oF She onacEssor Tegislers 
are pu : ,ted. 1mm Ftie user atHcfctwiUl lhe exception of lhe uaar 
Slack gonterhselF). 
Addressing Mode: Immedinle. 

Comments: A single 'aqisler may be pu!lfid tram the sla^k 
with condition cedes set by doiir; an jsutoinorerrienl load 
1rom iho slack (ewampw; LDX.U ■ • ) 



PULU 



Rotate Left 



Source Forms: nOL O; ROLA: ROLB 



Operation: 



,_C_ 



07 
Condilhsn Codes: 
W Not alifldod. 



I/' 



N Set if lhe Tesult is negative: c ear cd otherwise. 

Z Set if :he result is zerri, cleared otherwise. 

V —Loaded with (he result af tfie eAclusi™ Ofl of bits 
sijf and seven af 1fie onginal aper-iarid. 

C Leaded wilh bit sevar- oF 1hR D'igia^l aperand. 
DescrlpliOTi: Rotates all bits Of The operand one ptece left 
lh-3Lgh tht? C (carry) bt This is B 9-bit nnintion 
Addres-sing Mode: Inhcren!: Extended' Direr:: Irde^ed. 



ROL 



Rotate Right 



Soun» Forma: RGR Q: RDFfA; HORB 
Operation: 











c 


■ 












■ 






1 






H 



b7 
CondiKon Codes: 
H Not [i*ferJed. 



bo 



N Set rf the result is negative; r.fiared otherwise. 

Z Set if lhe result is zero: beared otherwise 

V — Not alfected 

C Loaded wilh bit zero of the previous operand 
Deserlplion: Rotates ail bfes of lhe operand one pface right 
ihrough the C (carry) t>t This is a 9 bit relation. 
Addressing Modes: Inherent. Exlended; Direct. Indexed. 



ROR 
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RTI 



Return from Interrupt 



Source Form: W' 
Operation: CCh '» £SP1. SP". 

IFFCCnblLiS^V iMur.: 



SP- 1. ihofl 
ACCA'< [&PI. SP' 



ACCB'- 
Dm' - 
1XH' . 
IM.- - 

JYH' r 

|Y|/ * 

U5H- * 
USL * 



tSPl. SP 1 
{&P3 SP 

tSPi, SP" 
tSP). SP 1 

[SP). SP 1 
ISPJ SP 
CSP>,SP 

(SP). SP 1 



SPt l 
SP i 1 
SP< i 
i;p- ' 

sp- 1 

SPi 1 
£P> i 

SPi I 

SP- 1 



RTS 



SBC 



SE V 



A 



Return from Subroutine 

Source Form Fi"S 
Operation; 

POH'- CSP> SP'* SPi 1 

PCL ■ tSPU. SP - SP . I 



Subtract with Borrow 

Source f (jrmt: SSC4 F; SBfJLl T 
Operation: ft ■ H M C 

Condition Codes: 
H L^CC-Med. 

M Sei il ihe resufl 15 negultuo: clewed otherwise 
1 Set 11 1** result is 7e* o: ctoored othtrw ■ 1 ■ 



Sign Extended 



i" R 

". 1 1 



ST 
it) 



Souf Ce Form: SEX 
Operation: 

II hn sA«fi ftf ACC6 is sst then ACCA'» FF^ 

■ MACCA'-. D0,„ 
Condition Codes; 
H NcrtuttDcted 



us- 



ST 
Bit ) 



Store Register into Memory 

Souicc Forms: 57A P\ STB P 
Operation; M - Ft 
Condition Codas: 

H NOI atfraaed. 

N Set irtterEsuH is negoine: dewed othofMnse. 



SUB 
(8-Bit) 



Store Register into Memory 

Sourea Forma: STD Pi STXfl 9TY P BTS P; STU P 
Operation: M M < 1- R 
CondHi on Codes: 

h NoL attested. 

N Set il Che resuU in neg:Llii>e: rJenrWJ otherurcsfc 



Subtract Memory from Register 

Source Perms: SLfBA Pi SUBS r 
Operation: R'< R M 
Condition Codas: 

H Undftlinert. 

M &CM (he resull is nagifivt; datred atherwse. 
Sot -tf fhe nesyll & zero ■ : kr-ored Otherwise 



PCH' 

PCL' 

IFF OCR nil Eis cte». dxm PCH 

PCL 

Condition Codes: RccoueroU from the 
Description: The suved machne state 
narewara- Slack and control il reftjmed 
orogr^m. \t ihe raoovftrftd E (entire) mt 
thot only a subse* 01 Ihe machine state 
address, and oondHcn codes.) and only 
norjtvefEd, 
Addressing Mode: Inherent. 



■ (SPJ. SP* SP y 1 

- (SPJ, SP- SP 1 1 

- tSPJ.SP- SP- 1 

- [SPJ. SP 1 - SP- 1 

stuck. 

■is recovered from the 
... ttni .,^, Vl . 

is doar, it indicntus 
was !iy vod (Tnlutfi 
thai subset a 



Condition Codes; Mot affected. 

Description; Program coetrcr is returned From the 

suamutinii 10 ihe calling praQram. Tfria return nfldress 

<s culled Jrom tne slue*. 

A0dr?3ung Mode: Rrs^rcmt 



V St t ii i*i <vwd*iw ^ gx JKrwn± dewoJ o#«nvi?e 

C Stl II j l3Crrr jW - i B gfnenT'.*d- dearctf oiMe^iw. 
Description: UubtraiSs ti,e comers; ni memory locaJion M 
ardi 3ie bvmi (*i Itte C loinrvJ biD frain tne cmnonts ot the 
designaiea S*ft regig^*-, and traces thq result In that 
fOfiister. Th* C tw itspresents a oorruw nnd Ii i^t to tho 
fflwrseoJ the nesyHtng ginmi\ ai"y 
Adtfressing Modes: Immediate- Ext&nd«*. Droct: Mirjmd 



N - Set ft ihe n BtA Ki nfttpgtfve: cfeareti otherwise 

Z Scf il the nusult \$ scro. dwnd uiherwise 
V NdI a1iedi»d 
c Aiot oHectod. 

OfiBcripliofii Thi? mslruclion UrstnsfEWTns H hK» compliment 
3-bit value n accumulator 6 into a twos complement ifl-hit 
value in lhc« D ascu^jlatui. 
AddnessJng Modor inherent 



1 Sot if the r^suit is 7¥.m: clc.vnd nEh(?rtfxiBe. 

V Always cKiUr'ed 

C f*£HanectiM 
Description: Writna the conients ar an 6-bit fogistef inio a 
nn/mnry Ipcation 
Addneaainjj Modes: UcHywled; Diregl Ircoejqjd. 



Z S«t ir th& result is wma, doarnd omww se 

V Alwrays cleared 

C WM affecled 
DaicripEkHi: Wirfes tt*e CWtefflS ol u ie-bfl cenjstef into tmj 
consEccl'-Mf. f-^mcyy locations 
Addnesslrin Modes: Lxtonond: Dirm.:l Indeii^. 



V- S^iltt»Cnwfaw[5^inc*wed;ci&iJL^oirii™^^ 

C Sat ir a t-^rrow is a«nL'rait>d steered otharvvige 
OostrlplsOn: Sjb1r:jt?s tnr> vulue in memnjy lucalton M 1rom 
tne conients aF a dKignated -•:.:■. g4ter The cCcunyJb* 

nEoresomsa tvmuw ard" is se* to (he inveraeal the resuifti^g 

l'i;irv u:n v 

Addressing Modes: Immediate; Exl«nctod; Direct- (ndexAd 
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Subtract Memory from Register 

Source Ftwrti: SUBD P 
Operation: R"- R W:M + 1 
Condilion Codes; 

H Mot afleded. 

N Set : t the result ;S negative: cleared otherwise. 

7. Set tf the rWSUU is ZQf C. Cleaned olherwisfi 



Software Interrupt 

Source Form; SWI 

Oper-alkinr 

Set L lenlirc state will be saved) 
5P'+ SP 1 <SPV PCL 
SP'-SP 1,.tSPf< PCH 
SP'+ SF 1.tSP)- USL 
SP 1 *- SP 1. tSPJ- U&H 
BPVSP i,[SPJ- IVL 
SP'*SP MSP)- IVH 
SPVSP i, [SP]. IXL 
SP'-SP 1. [SP)- IXH 



Software Interrupt 2 



Source Form: SWI2 
Operation: 

Sel E (enti 

SP 1 - SP 



SP 
SP 
SP 
SP 
SP 
SP 



r SP 

■ SP 
-SP 

- SP 
' SP 

' SP 

- SP 



re slate 

1. tSFh 
1. tSPJ- 
l.iiiKJ- 
1.CSPJ- 
1, tSP* 
1.SPJ. 
l [SP?' 
l . [SP)> 



saved! 
PCL 
PCH 
USL 
USH 
1YL 
IYH 
IXL 
IXH 



Software Interrupt 3 

Source Form: SWI3 
Operation: 

Set E Centre slnlp witl be saved) 
SF- SP 1. CSPK FCL 
1.EPV PCH 
' . [£? )- LJSL 
' . (SP). USH 
■ £SP) T IYL 
l.(SP)- l v P 
i, (SP)- IXL 



SP' 
SP' 

SP' 
SP' 
SP' 



SP 
SP 
SP 
SP 
SP 
SP 
Si- 1 



t. (SF 1 ). IXH 



V Sot il the overt low * generated; cleared Otherwise. 

C Sa! il a borrow is generated: cleared otherwise 
Description: Subtracts the value in memory locator 
M:M ' "i From ihe contents o1 a nesignaterl IG-bil register 
"The C (narr>) bit represents a bomow and is set to the 
inverse aF the resulting binary mrry. 
Addressing Modes: lr"-VK3Ciate. Emended; Direct: Indexed. 



SP- 

SP- 

SP'- 

SP'. 

So: !. 

PC 



SP 
SP 
SP 
SP 



(SP% PPR 
(SP^ ACCB 
fSPV ACCA 
(SPV CGF. 



Ftmask iterrupts) 

(FFFAMFFFB) 
Condition Codes: Not atlecteri 

Dascriplion: All of the processor registers -ire pushed onto 
the hardware Slack (wilh 1he exceptor nF the hardware ?.iar.k 
printer itselD. and COntlfOl is transferred through 1he software 
interrupt ™aof. Both Ihe normal 3/irj fast interrupts are 
m;jsJKed (disabled). 
Addressing Mode: inherent. 



SP r - SP I . F.SP)- DPR 

SP'- SP '.. (SP)* ACCB 

SP'. SP t (SP> ACCA 

SP'' SP 1, CSP> CCR 

PC 1 - «FFF4J:(FFF5S 
Condition Codes; Not af ected. 

Descriptkwir All o1 the processor registers are pushed OMo 
the hardware slat* [with the exception of the hardware stack 
printer il^el 1 ). and ccntrci is transtejred througfi the software 
interrupt 2 vector. Th*S interrupt is available to 1ha urd user 
and must not be used in packaged software This interrupt 
does not ^tsSk [disable) the nnrmal end Test mterrucls. 
Addressing Mode; Inherent 



SP 
SP 
SP 
SP 



1,<SP> 
1.<SPfr 
l.tSPJ- 
1.<5P> 



DPF1 
ACCF3 
ACCA 
CCR 



SP' 

SP' 

SP' 

SP'- 

PC- lFFf23:iFFF3) 
Condition Codes: Not allotted 

Description: All ol the processor registers are ousned onio 
1he hardware stacfc [w1h the exception of trie hardware Stack 
painter itsel?), and control is trans^ered through ihe software 
interrupt 3 vEdor. Th's interrupt does not mask [-disable* the 
ngrmai and Fast interrupts. 
Addressing Made: Inherent. 



BUB 
(IG-Bit) 



SHI 



SHI2 



SWI J 
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SYNC 



TFR 



TST 



FIRQ 



Synchronize to External Event 

Souf«? Fornix SVIvC 

Opcrah&n: Slop JVoceMiing instructions 

Candilion Codes: Stnt .ittec«!tJ 
DftKf ipiior: When a sync inntrudion is executed, the 
pmnrinnof enturj n synch rrmi7iny statu, Stops processing 
instructions, and *oils For an inlfflrupl. Whun. fir mier rup4 
occurs, the synchftjnijijin slain is cleared und processing 
eoniirtues HtfiemlpixtH is WKrt?dL artd if last throe cycles 
Of men?, the processor will perfonri the interrupt routine fF 
lh«j Interrupt is mHiskad or is shnrtK- thnn (he tie cycles, the 
proce&sor simply continues to the next inatfnucUon. While in 
lhe SsrnchronijJng Mute. lhe address and data •iwjtL-s an- 'i 
Lhe high impedance state. 

7P*a instruction provides software syncfrtfiizittori with a 
Fiurdware procer^. Consider the Fahnwjng <'*iirr;[jli.' ^ui I up |l- 
:=.pL!ihd acquisition o1 data: 



Transfer Register to Register 

Soyr«; Form: TFR flf. fJ2 

Operation: m -RP 

CenditFon Cod*: Nor afflclod unFOSS R2 LSthernndrteri 

code regis:ev 

Description; Trnn§Fers data PfltWBCn two dCJSiqnntRd 

r Pf; '-if--:- Bite 1-A rjl She poslhyfo ferine the Source fRg.tfur. 

whteb^3^i^A01hed?sIinHAiirin^i^ieT. osfotlws 
0000 AB tCOt) A 

0001 -X 1MI B 



Test 



Source Forma: TST □: TSTA. TSTR 
Oporathw: TEMP- W a 
Condition Codes: 

H NbianectedL 

N Sec il rriEt- result is negrt n -werti •"•frasst, 

2. Sst H tru* result ia pern. ■ 

V Always cleared 

C Not Kftactad, 



Fast Interrupt Reouest 
(Hardware Interrupt) 

Operation: 

IFFFaitdaEif, then: SP'> SP l [SPi- PCL 
SP'- SP x. [SPfc PCH 
CiCJf £ (subset slate n; rowr.) 

sp ■- s* 1 i. ta^ ccr 

Sol F, I imask furtiftf iptefnjptel' 

PC*- LFFFoltFFF/) 
Cond ilion Cod «: fjt H aFhecipd, 

Description: A nR&dasi interrupt reques;) wilh the I- i'si-.i 
mremtfrt requc^y mastd brt dew causes Ihijunlwn^i 
seej(icTcetoot.(:tra(Ttiee™jQ/ the Cu^eoi iftetrucTian TTn« 
progmm ccuntur rind nrxidrtan code. regwHF nre pushed 



FAST FiVKC 




WAIT FOR DATA 


Irtrerrjjp] 1 






LDA 


DH5C 


CWTA FROM C*5C AMD 

CLEAR INTCFtnUPT 


STA 


-X+ 


PUTIN BUFFER 


decs 




COUNT IT. DONE? 


BNE 


RftST 


CiO AtiAIM IF MQT 


the Synchrttfliring 3*l» b&CfeOTd 


oranyrtem*! CK 


course, itnabfctf intemi 


DtS .it this c 


k; ir -luv di.«,c:ov [tie dntn 



[ran&ter and, a£ Such, r>hDijlri r nprf;.i;r| tjnlj ■ ;r r, i -n h --"i^iy 

rone 1 or:-: 

lhe same oonmectJOn used tnr infer oipl-dnw/i l-O sorwee 
may abc bv used kv h<|Jvspe«?d d,ibi Banslers t»y seH«*n 

the interrupt mash and jsirg the SYNC irtelrutmon as [he 
.■■nnve eMampki d^^0f.-\'r\lps. 
Addreaalng Mode: Inheren! 



0010 v 1 010 CCR 

OOTi US 101 1 DPfl 

O'OO-SP moo Undefiwd 

OrOl-PC '101 UndeFmed 

::'!: unddinod 11 10 UnrleFin&rl 

D1 1 1 Undeftned 1 1 1 1 UidpfinR-J 

Onty tkr. ske registefii muy he transFotfed. (8 bl to at*. 

Of 16-Utot-S-bitl 

Addressing Mode: Irr-'-mJatg 



DesoripM<^: Sel the IS fnc-yafliwl and 7 tffiixu bits nccofdng 
to the COTCnrrs dF memHfy FocatiOrT W, ^nd clejir iho V 
toverffow) *iir Thft TST Instruction orgvides only rninirp.um 
in1drmQ|iftn when te~tincj unsigrlod values: since no unsigned 
^HJue Silas Shan zem, BLD rind BLS FiflvO m>aii% White 
EH coukJ tK used aher 1ST, it prcj^ndes exactly ftt s^ne 
nnptrnl m F^ir wrnrn i?, preiH7ed Thff sic/ied tynrw^ies $m 

ihir 
Actdnea-iirtg Mudes: Inherent; ExtnndisJ: D*fd Indexed. 
Coiiunwils: the MCBBW pnocfiiir.iv riuara ihu' C tcanyJ oil 



onto trw hnrdware stack, Prop, mm c:on5rol is. trancf erred 
through the fast inlenuot request vsctof. Art RTl [return from 
inHiuptl rit$,Tivction nrfums the processor In lUfr Ocinjinal 
last R is possib-e kj «ntcr the fast ifltemjpl fL-quv&I TOUtme 
win 1fX< entire Taehiny state saved \t the Tast inHrrupl 
requflSt OCCur^ aFter a cloar and vHWt 1dr interrjpl instruction 
A rarmai inderrupt requiK.1 ha:i IdwOr pfinril^' than the last 
rtemjj^ request and jS prevented liosn mltemjpl uiy Ctir 
Easl nterrupt (OQi^sl f CirKne by aulQmatc seninQ ^ ihu 
I [interrupt CEiduCSl masW bit. This mask ?ji[ cmjlrt lhen be 
reset OJtm^ tho intorrupf 'nutine M p.'iorj|y was not desired. 
The fasl in1r»trup1 request .-jllrm'!; opi iraticns Oh rntttnory. TST, 
JNC. DEC, eJc irtslniCHOns wrilhout Itw Overhead hi sawing 
lhe entre mach ne state on ihe stuck 
Addressing Mode: k^uynrt 



SO 



Interrupt Request 




(Hardware Interrupt) 


Sel E [entire stata saved) 


Operation: 


SP 1 - SP T.tSP)- C_CR 


IFF ! bil dear, Iham SP'- 5P 1, CSPH- PCL 


Se1 I (mask further IRQ interrupts} 


SP r - SP 1, CSP*. PCH 


PC' (FFF6KFFF9) 


SP 1 - SP 1, CSPV LJSL 


Condition Codes: Nat affected. 


SP'- SP 1, iSPI- USH 


Description; H [tie I (interrupt roquesl maskj bft is dear, a 


SP- SP 1, C5PV IVL 


low ic^cl cm ihe IRQ input causes this interrupt sequence lo 


SP- SP 1 (SPJ- IVH 


occur at ihe end o/| the current instruction Control is 


SP'< SP 1. <SP> !*L 


relumed to the inter upted program using a RTl [return rrom 


SP'- SP 1. 1SPJ- IXH 


iniemjpt) instruction. A FlRQ (1asl interrupt request) may 


SP'- SP 1, (SPJ- DPT1 


interrupt a rxjrnial IRQ tinierupt request) ruulinu utsd be 


SP'- SP 1. ISP)- ACC6 


recuyni^ud anvtimu u'tor lhu interrupt vector is taken 


SP'* SP 1. tS^J- A.CCA 


Addressing Mode: Inherent. 


Non-Maskable Interrupt 




(Hardware Interrupt) 


Sfvl 1 F [mask interrupts) 
PC + (FFFGWFFFD1 


Operation: 


Condition Ccntes: Ngt affected. 


SP'- SP MSP)- PCi. 


Description: A. negariw edge an lhe MMI {nnn^maskablF 


SP'' SP '.(SP)- PCII 


interRipl) inpul causes all of Ihe processors registers 


SF< SP MSP)- USL 


(aeapl the hardware stack poller) tc be pushed onto !he 


SP"- SP l.[SP)- USII 


hardware slacst starling at the end o( the currant instructinn. 


SP'- SP 1.[SP)-IYT_ 


^rograr^ control is transferred through The NfJi sector 
Successive negative; edges, on the NMl input will cause 


SP'* SP 1 , ESP)- IYH 


SP'* SP 1. ESP)- IXL 
SP- SP 1 [SP)- IXH 


successive NMl upurations. NDo-masfciafDlP interrupt 


nperatiDn can be nterna ! ly blocked 5y a HLSL" operation 


SP- SP l.(SP)- DPR 


rird any Tim-maskablEr infer upt lhat uccur:? will be latent?. IT 


SP - SP 1. fSP>< accb 


this happens, the non-maskable interrupt o-perahan will occur 


SP"- SP 1, fSP>- ACCA 


n^ter the. 1irj=.T load mtrs Ihe stark pointer [LDS; TFR r.sr, EXG 


Set C teniae state sa^c) 


r.s; etc > after RESET 


SP'- SP 1, (3P% CCF1 


Addressing Mode: Inherent 


Restart (Hardware Interrupt) 


Condition Codes; Not affected. 


Operation: 


Deserlpllori: The processor is initialled [required after 


CCR- X1X1XXXX 


power-on) to starl p* eg/am ejuecuton The slatting address 


DPP 1 - Q0 lt . 


is fetched frorr*. the restart vector. 


PC- (FFFEKFFFFr 


Addressing Mode: Extended; IrrcJimct 



IRQ 



NHI 



RESTART 
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Appendix A/ Editor Commands 

Definition of Terms 

- 

line 

A line number in the program. Any lines between 0-63999 may be used. These symbols may be used: 

# First line in the program. 

Last line in the program, 
Current line [see definition below). 

current fine 

The last Eire inserted, edited or printed. 

startfine 

The line where an operation will begin. In most commands startiine is optional. If omitted, the current fine is used. 

range 

The line or lines to use in an operation. If more than one line are in the range, they must be specified with one of these 
symbols: 

; to separate the startling from the ending line 

1 to separate the startiine from the number of lines 

increment 

The increment to use between lines. In most commands, increment is optional. If omitted, the last specified increment 
is used. On start-up. increment is set to 10. 

filename 

A 1-B character name of a tape file. 



COMMANDS 



PAGES 

DISCUSSED 



Cstaritine, range .increment 11 

Copies range to a new location beginning with startiine using the specified increment, startfine, 
range, and increment must all be included. 

C500iL00:150flE 

D range 11 

Deletes range. If range is omitted, current line is deleted, 

D10G 0100:150 D 

Eiine 10 

Enters a line for editing. If line is omitted, current line is used. 

Eiaa e 

These are the editing subcommands: 

A Cancels all changes and restarts the edit. 

nCstring Changes n characters to string. If n is omitted, changes the character at the 

current cursor position. 
nD Deletes n characters. If n is omitted, deletes character at current cursor 

position. 
E Ends line editing and enters all changes without displaying' the rest of the 

line. 
H Deletes rest of line and allows insert. 

I string Inserts string starting at the current cursor position. While in this Mode. ■ -} 

deletes a character. 
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nKcharacter Deleles at! characters from the current cursor position to the mh occurrence 

Of character. If n is omitted, deletes to the first occur re nce. 
L Lists current line and continues odit 

Quits the edit and ignores all changes. 

nScharacter Searches tor nth occurrence of character. It n is omitted, searches tor first 

occurrence. 
X Extends line, 

ENTER Ends line editing, enters all changes and displays the rest of the line 

■Shift. * Escape from subcommand. 

n SPACCeM' 1 Moves cursor n characters to the right. If n is omitted, moves one space 
n - Moves cursor n positions to the left. If n is omitted, moves the cursor one 

position. 

Fstring 

frnps the string of characters. Search begins with the current line and ends each time the string 

is found. If string is omitted, the last string defined is used. 

F 



H range 

Prints range on the Printer. Jf range is omitted, current line is printed. 

H10B M1(B0:Z00 H 

I startiine. increment 

Inserts lines beginning at starftine using the specified increment, startiine and increment are 
optional. 

H5B,5 J2H0 J,10 

L filename 

Loads the specified text file from cassette tape, ff filename is omitted, the next file is foaded. 

L SAnPLE L 

Mstarttine, range, increment 

Move command, works like copy except the original lines are deieted. 

ttstartfine, increment 

Renumbers beginning at startiine, using the specified increment siarWne and increment are 
optional. 

M)G8f5Q N1B0 H 

P range 

Displays range on the screen. 

P100J2B0 Piefl'5 P« P# 

p 



Returns to BAStC. Type EXEC 49152 to reium to Editor from BASIC, 

R startiine. increment 

Afiowa you to replace stariiine, and then insert lines using increment, startfinemd increment 
are optional. 

RlQQilB R100 R 



10 



11 



1D 



11 



10 



11 
11 
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ED3ASM+ 

COMMANDS DISCuIIeD 



Trange 1 

Prints range on the printer, without including the line numbers. 

Tlflfl T100S5OB 

^filename 

Verities filename to ensure that it is tree of checksum errors. Works like BASIC s SKIPF com- 
mand. If filename is omitted, verifies next file found. 

UTE5T 

Z 5, 11 

GotoZBUG. 



Scrolls up in memory. 
Scrolls down in- memory. 
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Appendix B /Assembler Command & Switches 




A filename switch . . . 

Assembles ttiy text program into machine code. Any of the following switches may be used: 

,'AO Absol ute Origin. (Applie&only if /I M is set. 3 

/IM In Memory Assembly. 

/LP Assembly listing on the printer. 

/MO M anual Orig i n . ( Appl i es o nly i f /I M is set. ] 

,'NL No listing printed, 

/ NO No obj yet code gen erated . 

/NS No symbol table generated. 

/SS Short screen. 

/"WE Wait on assembly errors. 

Unless the -'IM switch is used, the program will be assembled on tape using the specified o-o 
to eight character filename. If filename is omitted, NONA ME is used. 

Examples 

A SAflPLE/IM 
A 



PAGES 


DISCUSSED 


13 


15 


13 


13 


15 


13 


13 


13 


13 


13 
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Definition of Terms 



expression 

One or more numbers, symbols, or ASCII characters. If more than one are used, you may separate them with these 
operators' 

Multiplication * Addition + 

Division .DIV. Subtraction 

Modulus .MOD, Equals ,EQU. 

Shift < Not Equal .NEQ. 

Local And .AND. Positive + 

Exclusive Or .XOR. Negative 

Logical Or -OR. Complement .NOT 

address 

A location in memory. This may be specified as an expression using either numbers or symbols. 

filename 

A on? to eight character name of a tape file. 



C0MMANDS dkcSHed 



C 18 

Continues execution of the Dior: ram after interruption at a breakpoint. 

D 18 

Displays all the breakpoints that have been set 

E 

Exits ZBUG and enters tne Editor. 

Gaddress 1 3 

Executes the program beginning at address. 

L filename : ekter; i 1 g 

Loads the machine-code ftle from cassette tape. If filename is omitted, the next file is loaded. 

P filename first address last address start execution address 1 9 

Saves the contents of memory from start address to ending address on tape, execution 
address specifies the address where the program being saved begins execution. 

R 18 

Displays the contents of all the registers. 

Taddress 1 address2 1 9 

Displays the memory locations from addressl to addrsss2, inclusive. 

THaddresst addre$$2 19 

Prints the memory locations from addressl to address2, inclusive. 

U source address destination address count 

Transfers the contents of memory beginning at source address and continuing for count bytes 
to another location in memory beginning with destination address. 

Vfilename 

Verifies date on the specified file or the next file on the tape if no fiiename is specified, 
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COMMANDS PAGES 

i^jiviivmiNUO DISCUSSED 



Xaddress 1 g 

Sets a breakpoint at address. If address is omitted, the current location will be used. 

Yaddress *j3 

Deletes the breakpoint at the specified address. If address fs omiEted, all breakpoints are 
deleted. 

Examination Mode Commands 

A ASCII Mode 5 

B Byte Mode 5 

M Mnemonic Mode 6 

W Word Mode 5 

(the default is M) 

Display Mode Commands 

H Half Symbolic 1 7 

N Numeric f7 

S Symbolic 1 7 

(the default is S) 

Numbering System Mode Commands 

Obase Qutpul 21 

Ibase In pot 2t 

(taisccan be 8, 10, or 16. The default is T6J 

Special Symbols 

address 5 

register/ -j g 

Opens address or register and displays Us contents. If address or register is omitted, the last 
address opened wtfi be reopened. After the contents nave been displayed, you may type: 

New contents To change the contents. § 

.ENTfRj To close and enter any change, 5 

BREAK 1 To close and delete any change. 

* To open next address and enter any change. 5 

1* To open preceding address. 5 

'»' To branch to the address pointed to by the instruction beginning at the cur- 

rent location. 
: To force numeric display mode. 1 7 

= To force numeric and byte modes. 

: To force flags: 

address, 1 3 

Executes address. If address is omitted, the next instruction is executed. 

expression = 21 

Calculates expression and displays the results 

*The colon does not actually have anything to do with the CC (status flag] register. It simply 
interprets the contents of the given address AS JF it contained flag bits. 
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The following are descriptions of the error messages you can get while in the Editor, Assembler, or ZBUG: 



BAD BREAKPOINT (ZBUG) 

You are attempting to set a breakpoint C1 ) greater than 7, 
(23 in ROM, (33 at a SWI commend, (41 at en address 
where one is already set. 

BAD COMMAND (Editor) 

An illegaf command letter was used on the command fine. 

BAD COMMAND (ZBUG) 

You arc not using a ZBUG command. 

BAD LABEL (Assembler) 

The symbol you are using is [1 ) not a legal symbol. C2) not 
terminated with either a space, a tab. or a carriage return, 
or [3) has been used with ORG or END, which do not 
allow labels. [4] longer than six characters. 

BAD LINE NUMBER (Editor) 

You are using a line number that is not in the range of 
1-63999. If you are loading a file from tape, this could 
mean the tape is bad or the tape does not contain a TEXT 
file. 

BAD MEMORY (Assembler) 

You are attempting to do an in -memory assembly which 
would 11) overwrite system memory (an address lower 
than hexadecimal 0600], £23 overwrite the edit buffer or 
symbol table. (3) go into the protected area set by 
USRORG, or £4) go over the top of RAM. 

If using the^AO switch, check to see that you've included 
an ORG instruction. When using /MO, check the 
addresses you set for BEGTEMP and USRORG. This 
could also be caused by the data not being stored cor- 
rectly because of some code generated by an in- 
memory assembly. See the Chapter on Assembling for 
more information. 

BAD MEMORY (ZBUG) 

The data did not store correctly on a memory modifica- 
tion. This error will occur if you try to modify ROM 
addresses, or store anything beyond MAXMEM. 

BAD OPCODE (Assembler? 

The op code is either not valid or is not terminated with 
a space, a tab or a carriage return, 

BAD OPERAND (Assembler) 

There is some syntax error in the operand fiefd. See the 

syntax far the instruction in Section II. 

BAD PARAMETERS (Editor) 

Usually, this means your command line has a syntax 
error. 

BAD PARAMETERS (ZBUG) 

You have specified a filename greater than eight 
characters. 



BAD RADIX (ZBUG) 

You have specified a numbering system other than 10. 8 
one. 

BUFFER FULL (Editor} 

There is not enough room in the Edit Buffer for another 
line Of text. 

BUFFER EMPTY (Editor) 

The specified command requires that there be some text 
in the Edit Buffer, and there isn't any, 

BYTE OVERFLOW (Assembler) 

There is a field overflow in an 8-bit data quantity in an 
immediate operand, an offset, a short branch, or an FOB 
pseudo op. 

DP ERROR (Assembler) 

Direct Page error, The high order byte of an operand 
where direct addressing has been forced (- ) does 
not match the value set by the most recent SETDP 
pseudo op. 

EXPRESSION ERROR (Assembler and ZBUG) 

Same kind of syntax error in an expression or division 
by zero. 

FM ERROR (Editor and ZBUG) 

File Mode Error. The file you are attempting to load is not 

a TEXT file (if in the Editor) or a CODE file (if in ZBUG). 

I/O ERROR (Editor and ZBUG) 

Input/Output error. A checksum error was encountered 
white loading a file from a cassette tape. The tape may be 
bad, or the volume setting may be wrong. Try higher. 

MISSING END (Assembler) 

Every assembly language must have END as its last 
command. 

MISSING INFORMATION (Assembler) 

[1 } There is a missing delimiter in an FCC pseudo op, or 
[23 There is no label on a SET or EQU pseudo op. 

MISSING OPERAND (Assembler) 

One or more operands are missing from a command 
requiring one. 

MULTIPLY DEFINED SYMBOL (Assembler) 

A label has been defined more than one time. 

NO ROOM BETWEEN LINES (Editor) 

There is not enough room between lines to use the incre- 
ment you've specified- Specify a smaller increment or 
renumber CN) the text using a larger increment. Remem- 
ber that the last increment you usecf is kept until you 
specify a new one. 
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NO SUCH LINES (Editor? 

The specified line or lines do not exist. 

REGISTER ERROR (Assembler) 

(1) No registers have been specified with a PSH/PUL 
instruction. [2] A register has been specified more than 
once in a PSH/PUL instruction, or C3J There is a register 
mis- match with an EXG/TFR instruction. 

SEARCH FAILS (Editor) 

The string specified in the Find CF) command could not 
be found in the edit buffer, beginning with the line speci- 



fied. If no line is specified the current line will be used. 

SYMBOL TABLE OVERFLOW (Assembler) 

(1 ) The symbol table will extend past USRQRG into the 
protected area of memory. C2] There is not enough room 
between BEGTMP and USRORG for the edit buffer and 
symbol table. At least 300 hexadecimal bytes must be 
allowed for BEGTMP. CSee the chapter on Assembling.] 

UNDEFINED SYMBOL (Assembler) 

The symbol in the program was never listed in the label 
field or defined with an EOU statement. 
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DECIMAL 


HEX14B 


CONTENTS 


DESCRIPTION 


0-105 


0-59 


n r,-y:t Pmw RAM 


Can be used for machine-code programs. 


112-255 


70-FF 




Cannot be used for machine-code programs. 


25G-273 


100-111 


Internal Use 


Interrupt vectors. 


274-276 


112-114 


USRJMP 


Jump to BASICS USR routine. 


277-281 


115-119 




Can be used for machine-code programs. 


282 


MA 


Keyboard Alpha Lock 


- not locked; FF locked. 


283-284 


1 1B-1 TC 


Keyboard Delay Constant 




2S5-337 


11D-151 




Can be used by machine-code programs. 


338-34 £ 


152-159 


Keyboard Roliover Tables 




346-349 


15A-15D 


Joystick Pot Values 




350-1 0?3 


1 5E-3FF 


Internal Use 




1024-1535 


0400-05FF 


Video Texi Memory 




^53B-tvpafRAM 

top of RAM is 
1 6383 for 1 6K 
systems; 32767 
for 32K systems 


OBQQ-top of RAM 

tap of RAM is 

3FFFfor 16K 
systems: 7FFF 
for 32K systems 


If the Editor- Assembler is in control, it allocates these Random Access memory 
addresses in ihis manner (see ihe/MO and /AO switch in Chapter 4 for information on 
how to change this): 


1. Temporaries 

2. Edit Buffer 

3. Symbol Table 

4. Object Code 


Space reserved for temporary storage of EDTASM's 
variables buffers, and stacks (this consumes hexadecimal 
200 bytes! 

Storage space for the program lines you insert with the 
Editor. 

Storage space for all the symbols in your program and 
their corresponding values. 

Storage space for your assemble ?d program. 


If BASIC is in control it allocates these Random Aucess memciry locations in this 
manner 


1. Graphics Video 
Memory 


Space reserved for graphics video pages. S144 bytes or 
4 pages are reserved for this on start-up. This value can 
be reset by the PC LEAR statement: number of pages 
reserved by PCLEAR X 1 .536 bytes per page. [Note: All 
pages must start at a 256-byte page boundary i.e. , a 
memory location divisible by 256.3 




2. BASIC Program 
Storage 

3. BASIC Variable 
Storage 

4. Stack 


Space reserved tor BASIC Programs and Variables. 
6455* bytes C16K systemsJ or 22.339' bytes (32K 
systems) yrc reserved for this on start-up. This value can 
be reset by different settings of Random File Buffers, 
FCBs, Graphics Video Memory, Stnng Space or User 
Memory. 




5. String Space 


Total space for string data. On start-up. 200 bytes are 
reserved, hut this can be reset by the CLEAR statement. 


6. User Memory 


Total space for user machine-language routines. No 
space is reserved for this on start-up. but this can be 
reset by the CLEAR statement. 

Read Only Memory 


3276B-40959 


8000-9FFF 


Extended COLOR BASIC 
ROM 


40960-49151 A00O-BFFF 


COLOR BASIC ROM Read Only Memory 


49152-57343 . COOG-DFFF 


EDTASM - ROM Read Only Memory 


57344.-05279 E00O-FEFF 


Unused 




I 65280-65535 I FFOO-FFFF 


Input.QulpL: 
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Appendix F/ROM Routines 



The Color BASIC ROM contains many subroutines that 
can be called by a machine-language program. Each 
subroutine will be described in the following format: 

NAME — Entry address 
Operation Performed 
Entry Condition 
Exit Condition 

Note: The subroutine NAME is only for reference, 
it is not recognized by the Goior Computer. The 
entry address is given in hexadecimal farm; you 
must use an indirect jump to this address. Entry 
and Exit Conditions are given tor machine- 
fsnguage programs. 

BLKIN=tA006J 

Reads a Block from Cassette 

Entry Conditions 

Cassette must be on and in bit sync (see CSRDON), 
CBUFAD contains the buffer address. 

Exit Conditions 

BLKTYR which is located at 7C, contains the block type: 

- File Header 

1 -Data 

FF - End of File 
BLKLENL located at 7D. contains the number of data 
bytes in the block (0-255). 
Z*=1, A^CSRERR (if no errors). 
Z -0, A-CSRERR- 1 Lit a checksum error occurs). 
Z = 0, A - CSRERR - 2 (if a memory error occurs]. 

Note: CSRERFt- 81 

Unless a memory error occurs. X- CBUFAD - BLKLEN. 
If a memory error occurs, X points to beyond the bad 
address. Interrupts are masked. U and Y are preserved, 
all other modified. 

"Z is a flag in the Condition Code (CO register. 

BLKOUT = [A0081 

Writes a Block to Cassette 

Entry Conditions 

The tape should be up to speed and a leader of hex 5Ss 
should have been written if this is tho first block to be writ- 
ten after a motor-on. 

CBUFAD, located at 7E, contains the buffer address. 
BLKTYP, located at 7C, contains the block type. 
BLKLEN, located at 7D, contains the number of data 
bytes. 

Exit Conditions 
Interrupts are masked. 
X-CBUFAD + BLKLEN. 
All registers are modified. 



WRTLDR = IA00C1 

Turns the Cassette On and Writes a Leader 

Entry Conditions 

None 

Exit Conditions 

None 

CHROUT = IA0021 

Outputs a Character to Device 

CHROUT outputs a character to the device specified by 
the contents of 6F (DEVNUMX 
DEVNUM- 2 [printer) 
DEVNUM-0 [screen] 

Entry Conditions 

On entry, the character to be output is in A. 

Exit Conditions 

All registers except CC are preserved. 

CSRDON = [A004] 
Starts Cassette 

CSRDON starts the cassette and gets into bit sync for 
reading. 

Entry Conditions 

None 

Exit Conditions 

FIRQ and IRO are masked. U and Y are preserved. All 
others are modified. 

GIVABF=tB4F41 

Passes parameter to BASIC 

Entry Conditions 

D = parameter 

Exit Conditions 

USR variable- parameter 

INTCNV = [B3ED] 
Passes parameter from BASIC 

Entry Conditions 

USR argument - parameter 

Exit Conditions 

D = parameter 

JOYIN = [A00AJ 

Samples Joystick Pots 

JOY IN samples all four joystick pots and stores their val- 
ues in POTVAL through POTVAL + 3. 

Lett Joystick 

15A 
15B 



Up/Down 
Right/Left 

Right Joystick 
Up/Down 

Right-left 



15C 
15D 
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For Up/Down, the minimum value - UP 
For Right/Lett, the minimum value - LEFT. 

Entry Conditions 

None 

Exit Conditions 

Y is preserved. All others are modified. 

POLCAT = IA0G01 

Polls Keyboard for a Character 



Entry Conditions 

None 

Exit Conditions 

Z = 1 , A = (if no key seen). 

Z-0 r A - key code, lif key fs seen). 

B and X are preserved. All others are modified. 
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INDEX 



Absolute Origin Swilch 15 

ABX (Add AccumL?Jator B into IndCs Register X) 39 

ADC (And with Carry inlo Register) 39 

ADD (Add Memory mio Register) 32 

8 Bit ., 39 

T6-Bft yy 

AdC^CStTvig Modes 30 

Dired Addressing . 32 

Cxfoanried Addressing .31 

IndEXEri Addressing 31 

Inherent Add.'essing. 31 

IrnmetibgtG Addressing 31 

Relative Addressing 32 

AND tLegituI AND Memory into Register) . , , 39 
ANO < Luuk^al AND I mmadiahF Memory into 
Condition Cade RegisTer) . 39 

A Register .... 29 

ArithmElic OpErators . , , , 22 

ascji Motto . 5 

ASL fAri]hmet)C Shift LeflJ 33 

ASR (Amhmetic Shitl Right] 40 

Assembler Commands {Appendix Bl 56 

Assembling 13, IS, 25 

Assembling h MErnory SwiTcJi . . . ! 3 

Assembly Language Prion ram 30 

Command. The 3D 

Operand, The 30 

Addressing Modes 30 

Direst Addressing 32 

Extended Addressing 31 

Exrended Indirect . 31 

Immediate Addresses 31 

Indexed Addressing 31 

Indexed Indired Addressing 32 

Inherent Addressing 3T 

Relative Addressing 33 

Sy-^u \\'.: .. MH 

BASIC , , . . ... 25 

Assembling .... 25 

E*EQuting , 25 

Smnd-Afone Program 25 

Base Subroutine ?fi 

PaaHir'g Parameters 26 

Loading 25 

Revising . . 25 

BASIC Commann ...IT 

BABIC SubriLtinE ... 26 

BCC (Branch nn Carry Clear) . 40 

BCS (Branch on Carry Set) 40 

BEGTErvlR setting 15 

REQ (Branch on Equal) 40 

BGE [Branch un GrEtater than or Equal Id Zero) 40 

6GT CBrartcb an Greyer) . . . . 40 

BHI (Bmncti if Higher) '10 

BUS (Branch if Higher Qf Same) A 1 

BIT [Bit Test) A\ 

BLE CBmnchj Oil LsSS 1h3n dr Equal Id Zero) . . At 

BLO (Branch an LowerJ ,41 

BLS ttirund-iun Lower ar Sam?) ■ ■ .41 

BLT (Branch an Less Then Zero) ... 41 

BMI (Branch an Minus) .41 

BME (Branch NaT EquaO 42 

BPL (Branch on Plus) 42 

3RA (Branch Always) , .42 

Breakpoints, selling IB 

B Register . . 29 

BR.N (Branch Never) 42 

BSR (Branch Id Subroutine) . . 42 

BVC (Branch an Overflow Gear! ^.2 

Byte Mode s 



OC Register 29 

C {Carry) ...... 29 

E {Entire Flag) 29 

F CFast Interrupt RepuGSl Mask) 29 

h f Half Carry) 29 

I (Jhlerrupl) 29 

N iNegalive) , .29 

V (Overflow) ..29 

Z CZemd) , 29 

Changing Memory . ... 6 

CMP (Compare Memory from Register J 

a-Bil 42 

re-Bli 43 

COM rCunnJifjmunL) 43 

Co -jnds g 

Assembler Commands- (Aopendiy B) .... 53 

Copy Command , . , ■ 1 1 

DeletR Command 11 

Edit Commend 1 D 

Editor Commands (Appendix A) 55 

Insen Command , 11 

Load Command . 10 

Print Command 10 

Printer Commands ,10 

Renumber Command . ... 1 1 

Replace Command . . . , 11 

Write Command 9 

7BUG Command 11 

ZBUG Commands [Aopendix C) 59 

Campfflx Operaliong ?3 

Copy Command . ..11 

CWAI fCJear CC bits and Wait 1or InlEf rupl] . A J 

DAA (Decimal Addition i AdjusU 43 

DEC (DecrerrieniJ 44 

Direct Addressing 32 

Display Modes . 17 

HaH-Symbolic Mnde 17 

Numeric: Mode . 1 7 

Symbolic Mode 17 

Delete Command 1 1 

DP Register . . 29 

Edit Cornmand 10 

Editor Commands (Appends A) 55 

Lditar Error Messages (Appends D) ST 

ENO , 35 

EOR (Exclusive OR) ,44 

EQLJ 35 

Examimng Modes 5 

ASOl v-du 5 

Dytu Mode 5 

Mnemonic Mode , , 6 

\Vnnt Mods , 5 

Executing 25 

BASIC Subroutine 26 

Passing Parameters . . 26 

SUsnd-Alo'iE^ Program 25 

EXG (Exchange Registers) , \i 

Extendad Addressing 31 

ExTecded Indirect 31 

Extended Indirec" 31 

FCB ^ 

FCC 35 

FOB 35 

FIFO" (Fast Interrupt FreguesO Hardware? 50 

Flag?} 

C (Carry) 20 

E (Entire Rag} 29 

F (Fag! Interrupt Request Mask) 29 

K (Hall Carry) , , ... 29 

I tlnterrupt RerjuesT Mask) 29 



M iN'egativEl 29 

V ;Overf low) 29 

Z (Zpro) 29 

Go Command 17 

HaM-Symbolic Mod& 17 

Immediate Addressing Si 

INC ( increment] 44 

IrxJewtHJ Addressing .31 

Indeaec Indirect Addressing 32 

Indexed Icdired Addressing , 32 

Inherent Addressing , , , 31 

Incut Mode 21 

Inserl Command 1 ; 

Inst? uction Sei . 3,7 

Definrbon a' Terms , . 37 

Addressing Modes 37 

Crjndilion Codes .37 

Description 37 

Operation 37 

Source Forms 37 

Notations and Codes 3S 

IRQ {Interrupt Requesl) HardwO/u 61 

JMP Uur^q) ... 4i 

JSFl (Jump 10 SudroulncJ , . .44 

LD (Load HegiSTjer from Memcry) 

£R4 ^4 

16-Bit 45 

LEA (Load DfeCtrve Acdress) 45 

fisting Switches 

Load Cummand . . 

Loading 

Logical Operators 

LSL (Logical Shifl Left) . 
LSR (Logical Shirt Right) 
Martial Ongin Switch . . . 

Memory 

Savirfl Vdniary 



13 

10 

2& 

, 22 

45 

45 

. , 15 

19 

19 

Transferring a Block ol Mem&'y 19 

Memory Map [Appendix E) S3 

M icroprnoessof . , 29 

RegigTem 29 

A and B RegisLers 29 

CC Register 29 

DP Register ... 29 

PC Register ?9 

U ;ird S Registers 29 

X and Y Registers 29 

VnEmonic Mode . . . G 

Modes 

Adcessmg Modes so 

Extended Addmssinc 31 

Direcl Addressing 3? 

Inherent Addressing fjl 

Immediate Addressing , .31 

Indexed Addressing ...31 

RolaL-ve Addressing 32 

DiSfllay Modes . 1 7 

I ^;jl J -SyTiCnlir Mode 17 

Numeric Mode \ / 

Symbolic Mode 17 

Numbering System Modes ,2.1 

input 21 

Output 21 

MUL (rUulliply) 45 

NEGi fNerjale) 46 

NMKNon-Maskable Interrupt) Hardware 51 

No Objeci Code Switch 1G 

NOP (No Operation) 46 

Nolalions and Cooes 3-fl 



67 



Numbering Syslem Modes 

Input Mode 

QllIpuE Made 
Numem Mode- 
Operand. Trie- 

Addressing Modes 

Dparands , 

Operations 

■Complex Operaharei .... 

Dps rands 

Dpemtors , 

Arithmenc Operators 



21 

... 21 

21 

..... 17 

30 

30 

. 21 

21 

. .... 23 

, 21 

. 22 
. 22 



Relational Operators 22 

Logical Opurakirs 77. 

Operators 22 

Arithmetic: Operators . ?? 

Logical Operators ........ 22 

Relational Operators 22 

one . 35 

On Unclusive OR M emory into AogtsterJ 46 

OR (Inclusive OP Memory immediate into 

ConrJiljdri Cody flegiSterJ <JC 

Outpul Mods 7 1 
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